Installation

Installing Panelica takes one command and roughly 10 to 15 minutes, most of it automated download and setup time. Before you start, make sure your server meets the System Requirements.

The install command

Log in to your server as root (or a sudo-capable user) and run:

curl -sSL https://latest.panelica.com/install.sh | sudo bash

That is the entire installation. The installer needs no interaction: it runs 28 automated steps and prints its progress as it goes.

What the installer does

A condensed view of the major phases:

1. System requirements check: OS version, glibc, cgroup v2, RAM, free disk. Fails fast, before touching anything.
2. System dependencies: installs the handful of distribution packages Panelica needs.
3. Resource reservation: disables conflicting services (for example a stock Apache holding port 80).
4. Users, directories, permissions: creates Panelica's system users and its isolated directory tree under /opt/panelica/.
5. Package extraction: downloads and unpacks the full service stack: web servers, PHP versions, MySQL, PostgreSQL, Redis, DNS, mail, FTP.
6. Configuration generation: writes panelica.conf and every service configuration for your specific server.
7. SSL bootstrap: generates a self-signed certificate so the panel is HTTPS from the very first minute.
8. Database initialization and service startup: initializes PostgreSQL, starts all services, and brings the panel online.

Everything lands under /opt/panelica/. Panelica does not spread files across your system.

When it finishes

At the end of the installation the installer prints a summary that includes:

• Service status, plus a list of optional services (extra PHP versions, Postfix, Dovecot, ClamAV, pgAdmin4) you can enable later from Panel Settings → Services
• The panel URL: https://YOUR-SERVER-IP:8443
• The Recovery Console URL: https://YOUR-SERVER-IP:8444, an emergency console you can sign in to with the server's root password for diagnostics, repair and a root shell, even when the main panel is unreachable
• The Root/Admin Password generated for this installation

First run: the Setup Wizard

Open the panel URL in your browser:

https://YOUR-SERVER-IP:8443

Certificate warning is expected. The panel starts with a self-signed certificate, so your browser will show a security warning on first visit. Proceed past it; the connection is still encrypted. Once your panel has a hostname you can issue a trusted certificate for it.

On a fresh installation the panel greets you with the Setup Wizard (/setup). It walks you through the initial configuration in a few short steps:

1. Welcome: choose your language and start the setup.
2. Credentials: enter your administrator e-mail and set the panel's root password.
3. License: activate the server with a free trial or a license key.
4. Panel port: keep the default 8443 or move the panel to a custom port.
5. Terms of Service: review and accept.

When the wizard completes, sign in with username root and the password you set in the credentials step. From there the Dashboard is yours. The wizard's every screen is covered in detail on the First Login & Setup page.

Advanced: overriding installer checks

For lab environments the resource checks can be overridden with environment variables:

# Example: allow installation on a small test VM
curl -sSL https://latest.panelica.com/install.sh | \
  sudo PANELICA_MIN_RAM_MB=512 PANELICA_MIN_DISK_GB=10 bash