Installing Joomla Manually on Your Web Host
Learn how to install Joomla manually by creating a database, uploading the package, running the web installer, and securing your new site.
If you want full control over your Joomla setup, a manual installation gives you a clear view of every step. You create the database, upload the Joomla package to your hosting account, connect the files to the database, and finish the setup through Joomla's web installer.
This walkthrough explains how to install Joomla manually on typical shared hosting, such as a cPanel account, and what changes when you use a local server. Before starting, keep your hosting login, domain, database details, and a strong administrator email and password available.
What you need before installing Joomla
A successful installation depends on the server being ready before you open the installer. Prepare these items first:
- A hosting account or a local web server with PHP and a supported database.
- A domain or test address that points to the directory where Joomla will be installed.
- Permission to create a database and database user.
- Access to a hosting file manager, FTP client, or both.
- The current Joomla installation package from the official Joomla download site.
- A secure administrator username and password.
Your hosting plan also needs enough PHP capacity. The Joomla user documentation lists these minimum PHP settings for the installation environment:
memory_limit:256Mupload_max_filesize:64Mpost_max_size:64Mmax_execution_time:30
The upload and post size values matter later too. If they are too low, larger extensions may fail even when the core installation completes. If you are comparing plans, look for a best Joomla hosting option that lets you manage databases, files, PHP settings, backups, and SSL without unnecessary restrictions.
How to install Joomla manually step by step
The process has four main parts: create the database, download and upload Joomla, launch the web installer, and complete the first security checks. The names of control-panel menus vary by host, but the underlying steps are the same.
1. Create a database and database user
Open your hosting control panel and find its database management area. Depending on the provider, this may be labelled MySQL Databases, Databases, or Database Management.
Create a database, then create a user with a strong password. If your panel separates database creation from user permissions, assign the user to the new database and grant the permissions Joomla needs. Record the following values exactly as they appear:
- Database host or hostname, often
localhoston shared hosting. - Database name.
- Database username.
- Database password.
Some hosts add an account prefix to the database and username. For example, the name you enter may become accountname_site, so copy the full name shown in the control panel rather than relying on memory. Do not confuse the database password with the Joomla administrator password. They are separate credentials used at different stages.
For a local installation, you can create the database through a tool such as phpMyAdmin or the database server's administration interface. The same four values are needed when the Joomla installer asks for the connection details.
2. Download the Joomla package
Download the current Joomla release from the official Joomla download site. Keep the package in its original archive format until it reaches the server when your hosting file manager can extract archives there.
Using the official package helps you start with the intended core files. Avoid downloading installation archives from an unknown mirror or accepting a package that has been modified by an untrusted source.
3. Upload the archive to the correct directory
Sign in to your hosting file manager and open the document root for the domain. On many shared hosting accounts, this directory is called public_html. Other servers may use htdocs, a domain-specific folder, or another name shown in the hosting panel.
Upload the Joomla zip file to that directory. You can use either of these methods:
- File manager: Upload the archive, select it, and choose Extract. Extract it into the current document root when the panel offers that option.
- FTP client: Connect with the host, username, password, and port supplied by your hosting provider. Extract the archive on your computer, then upload the files and folders inside it to the document root.
The important detail is the final folder structure. If the files are in the domain root, Joomla should be reachable at an address such as https://example.com. If you upload the complete extracted folder into public_html, the site may instead appear at https://example.com/joomla.
Before continuing, open the directory and check that Joomla's files are directly inside it. Do not leave the whole package nested one level deeper unless that subdirectory is intentionally part of the site's URL. If you extracted locally, upload the contents of the Joomla folder, not an extra wrapper folder created by your archive utility.
4. Open the Joomla web installer
Once the files and database are ready, open your domain in a browser. For a local setup, use the local address configured by your server, such as http://localhost/your-folder.
If the files are in the expected location, Joomla displays its installation screen. The installer first asks for the site language and site name. Joomla may select a language based on your browser, but you can change it before proceeding.
The site name is the public name of the website. You can change it later in Global Configuration, so it does not need to be perfect at this point. Continue to the login data screen when the first form is complete.
5. Add the Super User account
The login data page creates the account with the highest level of control over the Joomla site and administrator interface. Enter:
- Your real name or the name you want Joomla to display.
- A unique administrator username. Avoid using
adminas the username. - A long, unique password stored in a password manager.
- An email address you can access for password recovery.
Treat this account as a security boundary. Do not share it for routine content work. After installation, create lower-permission accounts for people who only need to write, edit, or manage specific areas.
6. Enter the database connection details
The database configuration page connects Joomla to the database you created earlier. For a common MySQLi setup, enter the following:
- Database type: The type supported by your hosting environment, commonly MySQLi.
- Hostname: The database server address, often
localhost. - Username: The database user you created.
- Password: That user's database password.
- Database name: The full database name from the hosting panel.
- Table prefix: Keep the generated prefix unless you have a specific reason to change it. If you edit it, retain the ending underscore.
- Connection encryption: Keep the host's recommended default unless your provider has given you database encryption settings.
Check every value before selecting Install Joomla. A typo in the hostname, username, password, or database name commonly produces a connection error. The database credentials are not the same as the Super User credentials.
Joomla then creates its tables and shows installation progress. Do not close the browser or reload the page while that process is running.
What to do after the installation finishes
When the success screen appears, open the site and administrator area in separate browser tabs. The administrator login is normally available by adding /administrator to the site address, for example https://example.com/administrator.
Complete these checks before adding content:
- Sign in to the administrator area and confirm that the dashboard loads without warnings that require action.
- Open the public site and check that the domain resolves correctly.
- Confirm that HTTPS is active if your hosting account provides an SSL certificate.
- Review the recommended PHP settings shown by Joomla and ask your host about any setting that blocks a needed feature.
- Confirm that the installation directory has been handled by the installer. A production installation removes it automatically, while a development setup may require you to follow the on-screen instruction.
- Store your hosting, database, and administrator recovery details securely.
If you need a language other than the installation language, Joomla can install additional language packs during the completion process. Select the languages you need, then choose the default language for both the site and administrator interface. Add only what you plan to maintain so language updates remain manageable.
Common manual installation problems
The domain shows a directory listing or a blank page
The Joomla files may be in the wrong directory, or the domain may point to a different document root. Compare the domain's configured root with the folder where you uploaded the package. Make sure the Joomla files are directly inside the intended root and not inside an accidental joomla subfolder.
A blank page can also indicate a PHP problem. Check the hosting error log and verify that the server meets the Joomla requirements rather than repeatedly refreshing the installer.
Joomla cannot connect to the database
Recheck the complete database name and username, including any hosting-account prefix. Confirm the hostname supplied by the host, because localhost is common but not universal. Then reset or carefully re-enter the database password and verify that the user is assigned to the database.
The archive will not upload or extract
A file-size limit, an interrupted upload, or insufficient hosting storage can stop the process. Check the PHP upload and post limits, available disk space, and the file manager's upload status. If the control panel cannot extract the archive, extract it locally and upload the contents through an FTP client instead.
Extensions fail to upload after installation
This often points to upload_max_filesize or post_max_size being too low. Ask the host whether you can increase those values, then retry the extension upload. Also check that the extension supports your Joomla version before installing it.
The installer loads in the wrong language
Joomla may have selected the browser's language automatically. Choose the intended language on the first installer page. If you install language packs later, set the default site and administrator language separately during the final language step.
Manual installation versus a one-click installer
A one-click installer is faster when your host provides a trustworthy, maintained Joomla option. Manual installation is useful when you need to choose the package version, database, directory, or configuration yourself, or when the host does not offer an installer.
Manual setup also makes troubleshooting easier because you can identify which layer failed: DNS and document root, file upload, PHP configuration, database access, or Joomla's own installer. The trade-off is that you must create and connect each part yourself.
For local testing, a manual setup can also be a practical way to learn how Joomla works. If you are using Windows and IIS, see the steps for local Joomla development before uploading a site to production.
Security steps to take after installing Joomla
The installation is only the beginning of site maintenance. Start with a unique administrator password and keep Joomla, templates, and extensions updated. Remove extensions you do not use, review administrator accounts regularly, and limit access to hosting and database credentials.
Create a backup before major updates or configuration changes, and keep a copy outside the same hosting account. A backup is only useful if it includes the database and site files and can be restored. Review Joomla backup plugins when you are ready to automate that process.
Finally, test the front end, administrator login, contact forms, media uploads, and any important extensions after changing PHP settings or moving the site. A short post-install check can reveal a path, permission, or compatibility issue before visitors encounter it.
Frequently Asked Questions
Can I install Joomla without cPanel?
Yes. cPanel is only one way to manage the files and database. You can use another hosting control panel, an FTP client, and a database administration tool as long as you can upload Joomla, create a database user, and open the web installer.
Where should I upload Joomla files?
Upload them to the document root assigned to the domain. That folder is often named public_html, but the exact name depends on the host. The Joomla files should be directly inside that folder if you want the site to load at the main domain.
Do I need to create the database before uploading Joomla?
It is best to create the database first because you need its hostname, name, username, and password during installation. You can upload the Joomla package before creating it, but the web installer cannot finish until the database connection is available.
What is the Joomla administrator URL?
In a standard installation, add /administrator to the site URL. For example, a site at https://example.com commonly uses https://example.com/administrator for the administrator login.
Conclusion
Installing Joomla manually is a matter of preparing the server, creating a database, placing the package in the correct document root, and completing the built-in web installer. Take time to verify the database credentials and file location, then secure the administrator account, check HTTPS, and establish a backup routine. With those foundations in place, you can move on to configuring content, templates, and extensions with a clearer understanding of how the site is assembled.