Installing Joomla! for the first time is very easy. Joomla!’s built-in web installer makes setting up your new site a breeze.
Before we start installing Joomla!, there are a couple prerequisites that need to be met to install Joomla! <translate> 3.1 </translate>
successfully. These apply whether you have a dedicated server, a shared hosting plan server, or are installing a copy on a local computer for testing or development.
<translate> 3.1 </translate>
Software | Recommended | Minimum |
---|---|---|
PHP (Magic Quotes GPC off) | 5.4 + | 5.3.1 + |
Supported Databases: | ||
MySQL[1] (InnoDB support required) | 5.1 + | 5.1 + |
MSSQL | 10.50.1600.1 + | 10.50.1600.1 + |
PostgreSQL | 8.3.18 + | 8.3.18 + |
Supported Web Servers: | ||
Apache(with mod_mysql, mod_xml, and mod_zlib)[2][3] | 2.x+ | 2.x+ |
Nginx | 1.1 | 1.0 |
Microsoft IIS | 7 | 7 |
You will need two complete two tasks before you can install Joomla! on your server. First, you will need to download the Joomla! package files. Next, you will need to have a database for Joomla! use.
<translate> 3.1 </translate> ]
If you unpack the files on your own computer, then copy them to your server, be sure to move only the folders and files contained INSIDE the Joomla! package. If you unpack the folders and files into a folder, for example called, Joomla
and then upload that folder, your site will have to be accessed at yoursitename.com/Joomla
instead of yoursitename.com
.
dbserver1.yourhost.com
With the above requirements met, a database created and the required Joomla! files in place, you are ready to install Joomla!. Start the Joomla! web installer by opening your favorite browser and browsing to the site's domain name. On host installation you will use http://www.yoursitename.com
. If your are installing Joomla! locally, you will use http://localhost/<path to joomla files>
, and you should see the installation screen.
Joomla! will try to identify the Select Language field automatically from your browser's language. You can change this if needed.
Fill in the following information.
yoursitename.com
to view the home page. No - this means the site is live when you browse to yoursitename.com
to view the home page. You can use the Site Global Configuration in the Administration interface to change the Offline status at any time.
When everything on the first page is completed, click the next button to proceed:
You will need to enter the information about the database you will use for Joomla! now. It was suggested to write this information down under "Prepare for Install" tab. You may also read or review Creating a Database for Joomla!.
For simplification, these intructions are a reference to installing with a MySQLi database. The instructions on the installation page are self explanatory, but here they are again:
localhost
, but some hosts use a specific database server such as dbserver1.yourhost.com
jos3_
can be used. Just don't forget to put the underscore character(_
) at the end of the prefix.
All these choices can be edited on the Site Global Configuration page, under Server options after the installation is completed. Note, you will break your installation if you change these settings after installation unless you have a complete copy of the current database being used by the Joomla! installation. Common uses would be to update the username and password of the database or to complete a move of an existing installation to a new host with different parameters.
When all the information has been filled in, click the next button to proceed:
It is now time to finalise the Joomla! installation. The last page of the web brower installation contains all the information about the installation. This includes the options(at the top) for installing sample data and the installation's configurations(at the bottom).
The first options are for automatically installing sample content to the website and emailing the configuration settings.
If you are new to Joomla! it would be benefical to install some sample data to see how Joomla! works. You can at this time choose to have the configuration settings emailed to you. If the Email Configuation choice is selected, the Email Password choice will appear. The email password is off by default for security. You can choose to have the password included, just click Yes.
Time to check the configurations of your install and the environment of the installation.
If everything is in order, you will see the install at the top of the overview page. If not, this is the place to check and see what may be causing an issue.
The section is broken into 4 groups:
If everything is correct and all checks are passed, you may now click the Install button in the top right corner of the Overview page. This will start the actual installation process.
After you click the Install button, you should see a progress bar with additional information of the installation. Once the installation completes, you should see the success page!
Congratulations! Joomla! 3 is now installed, but there is one last step to complete the installation and start using your Joomla! powered site. You must delete the Installation Folder. Click on Remove Installation folder and a success message will appear. Now you can navigate to the Administrator log in by clicking Administrator or go right to your site by clicking Site.