User

Installing Joomla

How to install Joomla on a domain using Opterius Panel.

Last updated 1775606400
  • PHP Version
  • Troubleshooting
  • Next Steps
  • Opterius Panel can install Joomla automatically. It downloads the latest release directly from GitHub, extracts it, runs the CLI installer, and removes the installation directory — all in one step.

    Requirements

    • An active domain or subdomain on your account
    • PHP 8.1 or higher (recommended: 8.2+)
    • At least 256 MB disk space

    Installing Joomla

    1. In the sidebar, go to Software → Joomla
    2. Click Install Joomla
    3. Fill in the form:
      • Domain — the domain or subdomain to install on
      • Install Path — leave empty for the domain root, or enter a subdirectory (e.g. blog)
      • Site Name — your site's display name
      • Admin Username / Password / Email — your Joomla administrator credentials
    4. Click Install Joomla

    The installer typically completes in 1–2 minutes. During this time:

    • The latest Joomla package is downloaded from the official GitHub releases
    • Files are extracted to your document root
    • A database and database user are created automatically
    • The Joomla CLI installer runs
    • The installation/ directory is deleted (required for security)

    Once complete, your site is live at https://yourdomain.com and the admin panel is at https://yourdomain.com/administrator.

    After Installation

    Log in to Joomla Admin

    Go to https://yourdomain.com/administrator and sign in with the credentials you set during installation.

    Install a Template

    Joomla ships with basic default templates. To change the look:

    1. Go to System → Extensions → Install
    2. Upload a template or install from the Joomla Extension Directory (JED)

    Install Extensions

    Joomla extensions (components, modules, plugins) can be installed from System → Extensions → Install.

    Enable SSL

    If you haven't already, issue an SSL certificate for your domain. Then in Joomla:

    1. Go to System → Global Configuration
    2. Set Force HTTPS to Administrator and Site
    3. Save

    PHP Version

    Joomla 5.x requires PHP 8.1+. If your domain is running an older PHP version, switch it first:

    1. Go to PHP in the sidebar
    2. Select PHP 8.2 or newer for this domain

    Troubleshooting

    "Database error" during installation

    The database was created but Joomla can't connect. Check that:

    • The database server is running: systemctl status mariadb
    • The credentials in the install form were entered correctly

    White screen after installation

    Check the PHP error log. Usually a missing PHP extension — Joomla requires xml, json, mysqli, mbstring, and zip.

    "Installation directory still exists" warning

    This shouldn't happen as the installer removes it automatically. If it does, delete installation/ manually via the File Manager.

    Next Steps