Installing Joomla

From Joomla! Documentation

Other languages:
Deutsch • ‎English • ‎español • ‎eesti • ‎français • ‎Bahasa Indonesia • ‎italiano • ‎日本語 • ‎Nederlands • ‎中文(台灣)‎

Installing Joomla! for the first time is very easy. Joomla!’s built-in web installer makes setting up your new site a breeze.


Hosting Requirements

Before we start installing Joomla!, there are a couple prerequisites that need to be met to install Joomla! 4.x 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.

You’ll need to meet the following requirements to install and use Joomla!


Recommended PHP.ini Settings

There are some PHP settings that need to be sufficient for Joomla to install. The settings are usually in a "php.ini" or "user.ini". Talk to your host about how to change theses settings if it is possible to do so. If working on a localhost e.g. with XAMPP, you should not be restricted by these settings and VPS or dedicated hosting should also not be as restrictive.

The values for PHP.ini below are suggested values only.

  • memory_limit - Minimum: 64M Recommended: 128M or better
  • upload_max_filesize - Minimum: 30M
  • post_max_size - Minimum: 30M
  • max_execution_time: Recommended: 30

Prepare for Install

You will need to 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.

Downloading and Uploading Joomla! Package Files

Stop hand nuvola.svg.png

Currently Joomla 4 is in development and so here we are linking you to the nightly builds. These occasionally can be unstable. When Joomla 4.x is officially released - stable releases will be available as normal on [1]

  1. Download the current nightly release of Joomla! 4.x
  2. Move the downloaded Joomla! installation package to the server. Use a FTP Client to transfer the Joomla! 4.x files to your server. There are several available for use, here is a detailed list of FTP Clients. Please make sure you are using a FTP client's official release.
Hint - This can be accomplished by simply moving the downloaded package to your server, then unpacking it. Or you can unpack the files on your local computer, then move the Joomla installation over to your server. Either way, the Joomla installation needs to be unpacked in the root of your site.
Your Server's "root" Folder

Normally you upload your web files to the root folder. This is typically named "public_html" but other variations include "htdocs" and this depends on what your host has the set up on the server. For Joomla purposes, you can load the files directly into "public_html" or a sub-folder within it.

Stop hand nuvola.svg.png

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.

Database for Joomla! Installation

  1. If you need to create a database, please read "Create a database for use with Joomla!" first or skip to step #2.
  2. You will need to note basic database information needed when the actual Joomla! installation is started.
    • Location of database, localhost? Or a specific host's server such as dbserver1.yourhost.com?
    • The database name
    • The database user's name
    • The database user's password

Start Install

Main Configuration

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.

J4x Installation screen page 1.png

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.

When everything on the first page is completed, click the Setup Login Data button to proceed:

Login Data

You should now see the login data screen.

J4x Installation screen page 2.png

Fill in the following information.

  • Admin Name: the name of the admin. This how Joomla will greet you when you log in!
  • Admin Username: Joomla! uses a default "admin" as the username for the Super User. You can leave it as is, change it now (which a good Security measure) or use My Profile in the Administration interface to change it later.
  • Admin Password: remember that super user has maximum control of the site (frontend & backend), so try to use a difficult password. Use My Profile in the Administration interface to change it later. Confirm the password in the Confirm Admin Password box.
  • Admin Email Address: the admin email address. Enter a valid email in case you forget your password. This is the email address where you'll receive a link to change the admin password.

When everything on the second page is completed, click the Setup Database Connection button to proceed:

Database Configuration

Configuration Settings

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!.

J40 Installation screen page 3.png

For simplification, these instructions are a reference to installing with a MySQLi database. The instructions on the installation page are self explanatory, but here they are again:

  • Database Type: MySQLi is the common database used
  • Hostname Where is your database located? Common is localhost, but some hosts use a specific database server such as dbserver1.yourhost.com
  • Username: the username used to connect to the database
  • Password: the password for the database's username
  • Database Name: the name of the database
  • Table Prefix: one is generated automatically, but you can change it. For example, jos3_ can be used. Just don't forget to put the underscore character (_) at the end of the prefix.
  • Connection Encryption: specifies how the connection to the database should be encrypted. If you don't know - then it's best to stick to the default. However this allows enterprises who two way SSL encryption to the database to provide it.

All these choices and more 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.

After you click the Install Joomla button, you should see the Joomla logo spinning. Once the installation completes, you should see the success page!

Finishing Up

Success and Finishing Up the Installation

Congratulations! Joomla! 4 is now installed. If you want to start using Joomla! right way without installing extra languages there is one last step to complete the installation. 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.

J40 Installation screen page 4.png

You may see the following section beneath the Customise Installation Button.

  • Recommended Settings: these are settings are recommended in your PHP configuration, but will not prevent Joomla! from being installed. You can refer to the above instructions on how they may be changed.

Installing Extra Languages

Before you complete your installation by deleting the Installation Folder, click on:

   Install Additional Languages

This will continue the installation of Joomla! by taking you to a new installation page.

Install Languages

Stop hand nuvola.svg.png

To allow easy development we are currently allowing installation of Joomla 3.x language packs into Joomla 4. Many aren't compatible and are expected to be missing language strings. The ability to view 3.x language packs in the list on this page will be removed before Joomla 4 stable is tagged. Out of the 3.x language packs we recommend testing with French, German and Persian for now.

A list of language packs is displayed.

J40 Installation screen page 5.png

Check the language or language packs you wish to install. Remember the following:

  • Language packs included in custom distributions will not be listed at this stage as they are already installed.
  • A version of the packs proposed will match the Joomla Major version (4.0.x, 4.1.x, etc.). The minor version of the pack may not correspond, e.g. you are installing version 4.0.3 and a 4.0.2 language pack is shown.
  • Unmatched language packs in the above example may have untranslated strings.
  • The unmatched language packs will be offered as an update when the packs are updated by the registered Translation teams. The available update will be shown in the Control panel as well as in Extensions Manager  Update. This behavior is similar to Extensions Manager  Install Languages.

Click Next and a progress bar will be display while the language pack or packs are downloaded.

Choose Default Language

When the download is complete You will now be presented with a very similar Congratulations! Your Joomla site is ready. screen. The difference will be the addition of some options allowing you to choose the default language for the Site and the Administrator interface.

  • Make your choices for default languages.
    J40 Installation screen page 4 default langs.png

When you completed all the choices of language installation, click Set default language to confirm.


Now you can 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.