1) Overview

This guide shows you how to set up Joomla 6 both locally (for development) and on a live server (for production). We’ll create a database, copy files, and complete the Joomla web installer, then lock things down with essential security steps.

Tip: Always prototype locally first. You’ll build faster and avoid breaking a live site.

2) Requirements

Server software

  • Web server: Apache or Nginx
  • PHP: 8.0+ with common extensions (json, mbstring, xml, zip, gd)
  • Database: MySQL 5.6+/MariaDB 10.1+ or PostgreSQL 11+

You’ll need

  • Latest Joomla package: downloads.joomla.org
  • Local stack: XAMPP (Win/Linux) or MAMP (macOS)
  • FTP client (live): FileZilla or host File Manager
  • Text editor: VS Code, Sublime, etc.

3) Local install (XAMPP/MAMP)

3.1 Download and start services

  1. Install XAMPP or MAMP.
  2. Start Apache (or Nginx) and MySQL.

3.2 Create a database

  1. Open http://localhost/phpmyadmin.
  2. Create database, e.g. joomla6_db (utf8mb4, collation utf8mb4_unicode_ci).
  3. Local defaults: user root, password blank (unless you set one).

3.3 Place Joomla files

  • Find the document root:
    • XAMPP: .../xampp/htdocs/
    • MAMP: .../MAMP/htdocs/
  • Create folder joomla6 and extract the Joomla ZIP into it.
  • Visit http://localhost/joomla6.

4) Run the web installer (local)

  1. Site setup
    • Site name, admin email
    • Admin username and a strong password
  2. Database
    • Type: MySQLi
    • Host: localhost
    • User: root (or your user)
    • Password: (blank unless set)
    • Database: joomla6_db
    • Table prefix: leave default or randomize
  3. Install → wait for completion.
After install, click “Remove installation folder” when prompted.

Admin login: http://localhost/joomla6/administrator

5) Live server prep (cPanel/Plesk)

5.1 Check hosting

  • PHP 8.0+ and MySQL/MariaDB available
  • File manager and database tools in your control panel

5.2 Create DB and user

  1. In cPanel: MySQL® Databases → New database (e.g. acct_joomla6).
  2. Create a DB user and strong password.
  3. Assign user to database with ALL PRIVILEGES.

5.3 Upload files

  • Target directory:
    • Main domain: public_html/
    • Subfolder: public_html/joomla6/
  • Upload the Joomla ZIP and extract in place (faster via File Manager), or FTP all extracted files.

6) Run the web installer (live)

  1. Open your domain, e.g. https://example.com or /joomla6.
  2. Site setup: site name, admin email, username, strong password.
  3. Database:
    • Type: MySQLi
    • Host: often localhost (check host docs)
    • User: your DB user
    • Password: your DB user password
    • Database: your DB name
  4. Click Install Joomla.
Very important on live servers: delete the installation folder immediately when prompted.

Admin login: https://example.com/administrator

7) Post‑installation hardening

  • Change the default admin user to a unique username.
  • Enable HTTPS and force SSL (Global Configuration → Server).
  • Set file permissions (typical: files 644, folders 755).
  • Configure SEO URLs: enable URL rewriting and rename htaccess.txt → .htaccess.
  • Install and enable a backup extension; set scheduled backups.
  • Set up a staging site for future updates.

8) Troubleshooting

  • Blank page / 500 error: Check PHP error log; verify PHP 8+ and extensions.
  • Database connection failed: Re‑check DB name, user, password, host.
  • Installation folder not removed: Delete the installation directory manually.
  • Pretty URLs don’t work: Enable mod_rewrite and use .htaccess.

9) Next steps

◀ Prev Introduction to Joomla 6 Next ▶ Configure Global Settings