Joomla Learn
Joomla LearnThe practical desk
Getting StartedInstallationTemplates & ExtensionsSecurityTroubleshooting

How to Install Joomla Manually Without a One-Click Installer

Learn how to install Joomla manually on cPanel hosting by uploading the package, creating a database, running the web installer, and checking the first security settings.

How to Install Joomla Manually Without a One-Click Installer

If your host does not provide a Joomla installer, you can still get a site running through cPanel. The manual process is straightforward: download the Joomla package, upload and extract it, create a database and user, then finish the setup in your browser.

This guide explains how to install Joomla manually on typical cPanel hosting. It also covers the choices that commonly cause errors, the checks to make after installation, and the first steps to take before adding content.

Joomla files prepared for a manual hosting installation

What you need before installing Joomla manually

Prepare these items before opening the installer:

  • A domain or subdomain pointed to the hosting account
  • Access to cPanel and its File Manager
  • Permission to create a MySQL database and database user
  • The Joomla installation package downloaded from the official Joomla download source
  • A strong administrator password that you can store safely

Decide where the site should live. Uploading the package directly into public_html makes Joomla load at the main domain. Uploading it into a folder creates a separate path, such as example.com/site. The folder you choose should match the domain or subdomain you intend to use.

If you are still comparing hosting options, review Joomla hosting installation for a broader look at the server preparation and configuration decisions around a new site.

How to install Joomla manually in cPanel

1. Download the Joomla installation package

Get the current Joomla package from the official Joomla download source. Keep the downloaded archive in its original ZIP format while you prepare the hosting account.

Do not upload files from an unofficial mirror or an old package saved from another project. Starting with a current, trusted package reduces the chance of installing outdated code before the site is even configured.

2. Upload the package to your site folder

  1. Sign in to cPanel and open File Manager.
  2. Open the document-root folder for the domain or subdomain.
  3. Select Upload.
  4. Drag the Joomla ZIP file onto the upload page, or use Select File.
  5. Wait for the upload to finish before closing the page.

The ZIP archive should be inside the folder where you want Joomla to run. If the archive is in the wrong directory, the installer may appear at an unexpected address or the domain may continue to show an empty directory.

3. Extract the Joomla files

In File Manager, select the uploaded archive and choose Extract. If the extraction creates an extra directory, open it and check where the Joomla files ended up.

The Joomla files must be directly inside the site’s document-root folder for the main domain to load the installer there. If you see a path such as public_html/joomla-package/ but intended to use the root domain, move the extracted contents into public_html rather than leaving them one level too deep.

Keep the archive until the installation is complete and the site loads correctly. You can remove it afterward to avoid retaining an unnecessary installation package on the server.

4. Create a database and database user

Joomla needs a database to store configuration, users, articles, menus, and extension data. In cPanel, the MySQL Database Wizard is usually the clearest way to create the database and its user.

  1. Open MySQL Database Wizard.
  2. Enter a database name and continue.
  3. Create a database username and a strong password.
  4. Grant the user ALL PRIVILEGES for the new database.
  5. Finish the wizard.

Write down the complete database name, username, password, and host value. Some hosts add an account prefix to the database name and username, so the value you enter in Joomla may be longer than the name you initially typed.

A database user without the required privileges can let the installer connect but prevent Joomla from creating all of its tables. Assign the privileges before opening the web installer, not after the first failed attempt.

A database and user being prepared for Joomla configuration

5. Open the Joomla web installer

Open the domain or folder where you extracted the files. Joomla should display its installation screen in the browser.

The first screen asks for basic site details, including the installation language and site name. Choose the language you want to use, enter a clear site name, and continue to the administrator setup.

If the page does not appear, check the document-root location, confirm that extraction finished, and make sure the domain points to this hosting account. A blank directory or a hosting placeholder usually indicates a path or domain configuration issue rather than a database problem.

6. Add administrator details

Enter the requested administrator information:

  • The name associated with the administrator account
  • An administrator username that is not obvious
  • An email address you can access
  • A long, unique password

The administrator account controls the Joomla backend, so do not reuse a password from email, hosting, or another website. Store the credentials in a password manager and avoid using a predictable username based on the domain name.

Continue to the database connection screen when the details are complete.

7. Enter the database connection details

Choose the database type offered by your Joomla installation, then enter the connection values created in cPanel:

  • Database host or hostname supplied by your hosting provider
  • Database username
  • Database password
  • Database name
  • Table prefix, if the installer provides a default
  • Connection encryption setting, according to your hosting setup

Copy the values carefully. A single missing account prefix, extra space, or incorrect password can produce a connection error. When the fields are complete, start the Joomla installation.

The installer creates the database tables and writes the site configuration. Do not refresh the page repeatedly while that process is running. Wait for the completion screen, then follow Joomla’s prompt to enter the administrator area or view the site.

What to check immediately after installation

A successful completion message confirms that Joomla finished the installation, but a few checks are still worthwhile.

Test the public site and administrator login

Open the public site in a private browser window and confirm that it loads without a directory listing or hosting placeholder. Then open the administrator login page and sign in with the credentials you created.

If the public site works but the administrator page does not, verify that you are using the administrator path for the Joomla version you installed and that the files were extracted into the expected folder.

Review the global configuration

Inside the administrator area, review the site name, timezone, language, and metadata settings. Check that the live site setting reflects your launch plan and that the temporary installation values are not still being used.

Avoid changing several settings at once while you are learning the system. A small, documented change is easier to reverse when a template or extension later behaves unexpectedly.

Remove leftover installation files or archives

Follow Joomla’s own completion prompt for any installation directory cleanup. Also remove the uploaded ZIP archive after confirming the site works, unless you have a specific reason to retain it outside the public web directory.

Create a backup before customization

Make a backup before installing templates, extensions, or major updates. A useful backup must include both the site files and the database. Learn how to create and verify a Joomla site backup before the site contains important content.

Common manual installation problems

The installer shows a blank page

Confirm that the Joomla files are in the correct document-root folder and that the archive was fully extracted. A blank page can also result from a server configuration or PHP compatibility issue. Check your host’s error log and Joomla’s documented system requirements for the release you downloaded.

Joomla cannot connect to the database

Recheck every database field in the installer. Pay special attention to the account prefix added by cPanel, the database user password, and the database host value. Confirm that the user exists and has all privileges on the selected database.

The domain displays a hosting page

The domain may still point to another server, or Joomla may be installed in a different folder from the domain’s document root. Confirm the domain’s directory in cPanel and compare it with the folder containing Joomla’s files.

The site loads with broken links or missing assets

Check that the site URL and folder location match the way Joomla was installed. If Joomla is in a subfolder, use that path when testing links. Clear the browser cache after correcting the location and review the configuration settings in the administrator area.

The administrator password does not work

Make sure you are using the administrator username and password created during the web installation, not the cPanel credentials or database password. If the problem continues, use Joomla’s documented account recovery process or contact the hosting provider rather than editing the database without a backup.

First steps after a clean Joomla installation

Once the site is accessible, build a stable foundation before publishing heavily:

  1. Confirm that administrator login and public pages work.
  2. Set the site name, timezone, language, and metadata.
  3. Choose a template that supports your content structure and accessibility needs.
  4. Install only extensions that have a clear purpose and are compatible with your Joomla release.
  5. Configure a backup routine and test that a restore is possible.
  6. Keep Joomla, templates, and extensions updated.
  7. Create separate administrator accounts instead of sharing one login.

For the next stage, use this Joomla beginner tutorial to organize content, menus, templates, and extensions without losing track of the site structure.

Frequently asked questions

Can I install Joomla without cPanel?

Yes. The same basic process works with another hosting control panel or an FTP and database toolset. You still need to upload and extract the Joomla files, create a database user with the required privileges, and open the installer at the correct domain or folder.

Should Joomla files be inside a separate folder?

Only if you want the site to run at a subdirectory or your hosting setup requires one. For a site at the main domain, place the extracted Joomla files directly in that domain’s document root.

What database details does Joomla need?

The installer needs the database type, database host, database name, database username, and database password. Depending on the installer and host, it may also ask about a table prefix and connection encryption.

Can I delete the Joomla ZIP file after installation?

Yes. Once the files are extracted and the site is working, the archive is no longer needed in the public site folder. Removing it keeps the installation directory tidy.

What should I do before adding extensions?

Log in successfully, review the global configuration, confirm the site works publicly, and create a backup. Then add one extension at a time so you can identify the cause if a new feature creates an error.

Conclusion

To install Joomla manually, upload the official package to the correct hosting folder, extract it, create a database and user in cPanel, then complete the browser-based setup with accurate administrator and database details. After Joomla loads, remove leftover installation files, verify both login areas, and create a backup before making major changes.

A careful first installation makes later template, extension, security, and content work much easier to manage.