How to Install Joomla Manually Without a Hosting Auto-Installer
A manual Joomla installation does not require Softaculous, Installatron, a hosting one-click installer, or any other deployment service. You download Joomla's official Full Package, place the files in the website's document root, create a database and database user, and then complete Joomla's built-in web installer in your browser.
Before you start
Make sure the hosting account can run the Joomla version you intend to install. You need a supported PHP environment, a supported database server, a functioning web server, a writable location for the Joomla files, and the ability to create or obtain a database and database user. If the target directory already contains a website, back it up before replacing or removing anything.
You also need the final website URL and access to the hosting account by at least one file-transfer method, such as a web-based file manager, SFTP, or SSH. Manual installation is not a workaround for hosting that lacks Joomla's underlying technical requirements; it only replaces the convenience layer of an auto-installer.
1. Download the official Joomla Full Package
Get the current stable Full Package from Joomla Downloads. Use a package intended for a new installation, not an update-only package. Keep the archive intact until you are ready to place it on the server.
Using the official package avoids stale copies that a host's installer catalog may not have updated yet. If you are deliberately installing an older supported Joomla branch for compatibility reasons, obtain that exact release from Joomla's official download archive and plan to apply all available security and maintenance updates for that branch.
2. Identify the correct document root
Find the directory the web server uses for the domain you are installing. On many shared hosts the primary domain uses a directory such as public_html, while addon domains and subdomains may have their own document roots. Do not choose a folder based only on its name; confirm the mapping in the hosting control panel or with the provider.
If the site should load at https://example.com/, Joomla's index.php ultimately needs to be in the document root for that URL. If you put the entire extracted Joomla package inside an extra folder, the site will instead be reachable at that additional path.
3. Upload and extract the Joomla package
Upload the Joomla archive to the target document root. When the host provides a file manager with server-side extraction, uploading one archive and extracting it on the server is usually preferable to transferring the unpacked tree one file at a time. SFTP or another secure transfer method is also suitable.
After extraction, verify that Joomla directories such as administrator, components, includes, installation, and files such as index.php are directly in the intended document root. Remove accidental nested package directories before continuing.
4. Create the database and database user
Create a new database and a database user. Grant that user the privileges needed to create and manage tables in the new database. Record:
- database host;
- database name;
- database username;
- database password.
On many shared hosts the database host is localhost, but Joomla's documentation specifically notes that some providers use a different database server hostname. Use the value your provider gives you. The database user is not the Joomla Super User.
5. Open the Joomla installer
With the files and database ready, browse to the final site URL. Joomla should detect that it is not yet configured and display the installation interface. If you see a directory listing, a different application, a 404, or a blank page instead, stop and fix the document root or hosting environment before proceeding.
6. Enter the site and Super User information
On the first installer page, choose the language and enter the Site Name. Continue to Setup Login Data and create the first Super User. Joomla's current installer asks for:
- Real Name;
- Super User account username;
- Admin Password;
- Super User Email Address.
Use a unique password and avoid a predictable administrator username such as admin. Keep these credentials separate from the database credentials.
7. Configure the database connection
On Database Configuration, enter the database type, hostname, username, password, database name, and table prefix. Joomla generates a table prefix automatically; in a normal new installation, accepting the generated prefix is appropriate unless you have a specific reason to use another unique prefix.
If Joomla cannot connect, do not repeatedly change unrelated settings. Check the exact database host, account-prefixed database/user names used by some shared hosts, the password, and whether the database user was actually granted access to that database.
8. Complete installation and verify both interfaces
Select Install Joomla and wait for the success screen. A normal production installation removes the installation directory as part of completion. Open both the site and Administrator interfaces and verify that they load:
https://example.com/
https://example.com/administrator/Log in to Administrator with the Super User account. Check for recommended PHP-setting warnings and obvious environment errors before adding extensions or building the site.
9. Clean up and establish a safe baseline
- Delete the uploaded Joomla archive from the public document root after you no longer need it.
- Make a known-good backup of the fresh installation before substantial customization.
- Confirm HTTPS works without browser warnings.
- Check Joomla's update screen and install any newer maintenance/security patch appropriate for your branch.
- Configure outgoing email and test it before relying on password-recovery messages.
- Do not enable URL rewriting until the basic site works correctly.
Manual-installation problems to check first
- The installer never appears: verify the package was extracted into the actual domain document root.
- 403 or permission error: verify file ownership and permissions with the host rather than making the entire site world-writable.
- PHP fatal error or requirements message: check the PHP version, extensions, and host configuration for the target domain.
- Database connection failure: re-check all four database connection values and the user's privileges.
- Site works but assets are missing: look for a nested directory, incorrect document root, stale cache, or hard-coded paths from something other than a clean Joomla package.
Need More Help with Joomla?
Still having trouble? Open a support ticket with QuantaCade Support and we'll be happy to help where we can.
Support priority is given to QuantaCade products, services, and customers. However, we're also happy to assist fellow Joomla users with general Joomla questions and troubleshooting when possible.
QuantaCade is an independent Joomla extension developer and is not official Joomla support. Some issues involving third-party extensions, hosting environments, server configurations, or other systems outside our development control may be beyond what we're able to resolve.