Install Joomla on Plesk
Install Joomla on your Plesk hosting: PHP and database requirements, official package upload, installation wizard, friendly URLs and fixes for common errors.
On this page
Your values
Enter them once and the commands in this guide update.
This guide shows you how to install Joomla on your Plesk hosting from the official package, then check that the site and its administration area are working.
Prerequisites
- Access to your Plesk panel (see Connect to Plesk interface).
- A domain attached to your hosting and pointing to it.
- An empty
httpdocsfolder, or a backup of it if it already contains a site.
This guide uses httpdocs, the usual folder for the main domain. For an additional domain, the folder may be different: check the Document root under Hosting & DNS > Hosting.
Here are the official requirements for Joomla 6, the current branch at the time of writing. Check them in the Joomla manual if you are installing a later version.
| Item | Minimum supported | Recommended |
|---|---|---|
| PHP | 8.3.0 | 8.4 |
| MySQL | 8.0.13 | 8.4 |
| MariaDB | 10.6 (10.4 as the absolute minimum) | 12.0 |
The PHP modules json, simplexml, dom, zlib, gd and mysqlnd or pdo_mysql are required, and mbstring is recommended. Allow a memory limit of at least 256 MB.
Step 1: configure PHP
-
Go to Websites & Domains and find your domain.
-
Open PHP (or PHP Settings, depending on your Plesk version).
-
Select PHP 8.3 or a more recent version.
-
Apply at least the following values:
Setting Value memory_limit256Mupload_max_filesize64Mpost_max_size64Mmax_execution_time30 -
Save.
Step 2: create the database
Create a database and a dedicated user by following the Create a database guide. Write down the database name, the user, the password and the host name shown in the database connection information (often localhost).
You can find out your database server version by opening phpMyAdmin from the Databases page.
Step 3: download Joomla
On the official download page, get the Full Package in .zip format. At the time of writing, the latest version is 6.2.0.
Step 4: upload and extract the files
- In Plesk, open Files, then the
httpdocsfolder. - Delete the default
index.htmlpage if it is there. Otherwise, it would be displayed instead of the installation wizard. - Upload the Joomla archive.
- Select the archive, then click Extract Files.
- Check that
index.phpand theinstallationfolder are directly inhttpdocs, not in a subfolder. - Delete the archive.
If you prefer to use an FTP client (see Change your FTP password), unzip the archive on your computer first and upload its contents.
Step 5: run the installation wizard
Open https://your-domain.com/ in your browser. If your domain does not have a valid SSL certificate yet, use http:// temporarily.
Language and site name
Select the installation language, enter the site name, then click Setup Login Data.
Super User account
Fill in:
- your real name;
- a username, preferably something other than
admin; - a password of at least 12 characters;
- an email address you have access to, which is useful for recovering your account.
Then click Setup Database Connection.
Database
| Field | Value |
|---|---|
| Database type | MySQLi |
| Host Name | localhost, or the value shown by Plesk |
| Username | The user created in step 2 |
| Password | This user's password, not the Super User password |
| Database Name | The database created in step 2 |
| Table prefix | Keep the generated value, with its trailing _ |
| Connection Encryption | Leave the default value |
Click Install Joomla and wait.
End of the installation
The Congratulations! screen confirms that the installation is complete. From there, you can add languages, then open the site with Open Site or the administration area with Open Administrator.
Joomla deletes the installation folder itself. Check httpdocs anyway: if this folder still exists, delete it.
Step 6: enable friendly URLs
This step is optional, but it removes index.php from your page addresses.
- In Files, open
httpdocsand renamehtaccess.txtto.htaccess. - Log in to the administration area, then open System > Global Configuration.
- In the Site tab, enable URL rewriting (Use URL Rewriting).
- Save, then open several pages of the site.
Check the result
https://your-domain.com/displays your site's home page.https://your-domain.com/administrator/displays the login page, and your Super User credentials work.- The
installationfolder no longer exists inhttpdocs. - The dashboard does not report any pending security update.
Troubleshooting
The default Plesk page is displayed
The index.html file takes priority over index.php. Delete it from httpdocs or rename it, then reload the page, bypassing your browser cache.
Sorry, your PHP version is not supported.
The domain's PHP version is too old. Select PHP 8.3 or more recent in PHP, then reload the page.
You need MariaDB ... or higher to continue the installation
The database server does not meet the requirements of this Joomla version. The message shows the expected version and the current version. Contact support from your client area to find out the possible solutions.
The database details provided are incorrect and/or empty.
Check the host name, the user, the password and the database name. Copy the database name from Plesk, as it may include a prefix.
Joomla asks you to delete a file to confirm that you own the site
This check appears when the database server is not local. If your database is on the same hosting, use localhost. Otherwise, delete the file named in the message from the installation folder, then run the step again.
The "..." folder could not be deleted. Please manually delete the folder.
Delete the installation folder from Files or over FTP. If it remains in place, Joomla may send you back to the wizard.
404 error on every page except the home page
URL rewriting is enabled while the .htaccess file is missing or not supported. Check the exact file name, including its leading dot. If the problem persists, turn off the option in the global configuration and contact support.
500 error after creating .htaccess
Temporarily rename .htaccess to confirm that it is the cause. The Joomla guide notes that the Options +FollowSymlinks line can cause problems on some servers: try commenting it out by adding # at the start of the line.
Blank page or general error
Check the domain's Logs and the administrator/logs folder. For more details, temporarily set $error_reporting to 'maximum' in configuration.php, then return it to 'default' after troubleshooting.
Uploading an extension or a file fails
Increase upload_max_filesize and post_max_size in PHP. The second value must be at least equal to the first.