Jun 2, 2026 · CMS · 1min read

Installing Joomla on localhost

Install the Joomla CMS in a local PHP environment and set up and debug your website at http://localhost/joomla.

Joomla is a popular open-source CMS that sits between WordPress and Drupal, suitable for portals, communities, and corporate showcase sites. Local installation facilitates the development of templates and extensions.

Prerequisites

PHP 8.1+ (according to Joomla’s official requirements)
MySQL/MariaDB or PostgreSQL
Apache (recommended) or Nginx

Installation Steps

Download the Full Package from joomla.org
Extract to htdocs/joomla/
Create a database joomla_local in phpMyAdmin with collation utf8mb4_unicode_ci
Access http://localhost/joomla
Fill in the installation wizard:
- Site name and admin account
- Database host: localhost
- Database user/password
- Table prefix: default jos_ is fine

Common Paths

Path	Description
`/joomla`	Site homepage
`/joomla/administrator`	Admin panel
`/joomla/templates`	Frontend templates
`/joomla/components`	Components

Local Development

Enable “Debug Mode”: Global Configuration → System → Debug System
Template Overrides: Copy templates to a custom location or use child templates
Extension Installation: Admin panel “System → Install → Extensions”

Frequently Asked Questions

Blank homepage after installation
Check the PHP error log; ensure the database configuration in configuration.php is correct.

SEF URL 404
Global Configuration → Site → SEO Settings; Apache requires .htaccess and mod_rewrite.

Upload Limitations
Increase upload_max_filesize and post_max_size to install large extensions.

Summary

The typical local address for Joomla is http://localhost/joomla, with the admin panel at http://localhost/joomla/administrator, requiring a PHP + MySQL environment.