Joomla! Content Management System
This page explains how to install the Joomla Content Management System (CMS) onto your Web site. Joomla is free and allows you to edit and create Web pages online through your Web browser.
These instructions are based on Joomla 3. These instructions assume that you're installing Joomla at the top level of your Web site; if you choose to put it elsewhere on your site, be sure to change the paths and URLs to match.
1. Get Joomla
Download the most recent zip version from http://www.joomla.org/ onto your own computer, and then extract the files. This creates a folder named something like "Joomla_3.0.1-Stable-Full_Package" on your computer. For your convenience, you might want to rename this folder to something simpler like "joomla".
2. Create a MySQL database
Joomla uses a MySQL database to store the blog entries. We recommend creating a new database specifically for Joomla, rather than using an existing one. To create the database on our servers, follow our instructions explaining how to create a MySQL database.
There's no specific format you need to follow when naming the database. The rest of these instructions will assume that your database is called "jmexample" — if you use a different name, just use that name instead of "jmexample" when following the instructions below.
3. Move the Joomla files to your Web site
Use an FTP program to publish the "contents" of the "joomla" folder (not the actual folder itself) to whatever location on your Web site you want to use for your Joomla files (usually the top level of your Web site). This process can take several minutes since Joomla is a large software platform that contains thousands of individual files.
Please note that the folder (directory) into which you upload your Joomla files should not contain any other files named index.html, index.htm, or index.shtml. This is necessary because otherwise those default pages would be served before Joomla's index.php page. In particular, if you upload Joomla into the top level of your Web site, be sure to delete (or rename) any conflicting default page file.
4. Start the installer
If you uploaded Joomla to the top of your Web site you can start the installer by going to http://example.com/. The "Main Configuration" page should then appear:
- Site Name: enter anything you want
- Site Description: enter a description of your Web site
- Your Email: enter an e-mail address that can be used for administrative purposes
- Admin Username: choose a name for administrator user, such as admin
- Admin Password: choose a strong password for the administrator user
- Confirm Admin Password: re-type the administrator password
You can leave the "Site Offline" toggle to No if you would like your Web site to be published immediately after you finish the installation.
Click Next to continue. The "Database Configuration" page appears:
Enter the following for the database "Basic Settings":
- Database Type: MySQLi
- Host Name: localhost
- Username: enter the "MySQL User Name" that you created in step 2 above (for example, jmexample)
- Password: enter the password for the MySQL database that you created in step 2 above
- Database Name: enter the "MySQL User Name" that you created in step 2 above (this must be the same value as you entered for "Username" two fields above it)
- Table Prefix: accept the suggested default value, unless you have a specific reason to change it.
- Old Database Process: Backup
Click Next to continue. The "Overview" page appears:
If you would like to install the sample data, which is recommended if you are not familiar with Joomla, select a Sample Data to install.
The rest of the screen is an overview of the settings you filled in. You can have the configuration settings emailed to you by switching the Email Configuration toggle to yes.
Click Install to proceed with the installation. The "Installing" page appears:
The "Congratulations" page appears when the installation is finished.
That's it, make sure you delete the installation folder by clicking on the Remove Installation Folder button.
If you uploaded Joomla to the top of your Web site you can now use it by going to http://example.com/.