EN

Web hosting

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.

7 min read, updated on 18 November 2026

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 httpdocs folder, 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

  1. Go to Websites & Domains and find your domain.

  2. Open PHP (or PHP Settings, depending on your Plesk version).

  3. Select PHP 8.3 or a more recent version.

  4. Apply at least the following values:

    Setting Value
    memory_limit 256M
    upload_max_filesize 64M
    post_max_size 64M
    max_execution_time 30
  5. 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

  1. In Plesk, open Files, then the httpdocs folder.
  2. Delete the default index.html page if it is there. Otherwise, it would be displayed instead of the installation wizard.
  3. Upload the Joomla archive.
  4. Select the archive, then click Extract Files.
  5. Check that index.php and the installation folder are directly in httpdocs, not in a subfolder.
  6. 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.

  1. In Files, open httpdocs and rename htaccess.txt to .htaccess.
  2. Log in to the administration area, then open System > Global Configuration.
  3. In the Site tab, enable URL rewriting (Use URL Rewriting).
  4. Save, then open several pages of the site.

Check the result

  1. https://your-domain.com/ displays your site's home page.
  2. https://your-domain.com/administrator/ displays the login page, and your Super User credentials work.
  3. The installation folder no longer exists in httpdocs.
  4. 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.