Docs / Installing Nimbopanel

Installing Nimbopanel

Requirements

Nimbopanel installs on a fresh Linux server you control (a VPS or dedicated box) — not on shared hosting. You need:

  • A freshly provisioned x86_64 (64-bit) server running a supported OS:
    • Ubuntu 22.04 LTS or 24.04 LTS — fully supported and recommended.
    • AlmaLinux, Rocky Linux, or RHEL 9 / 10 — experimental (beta); review the result before relying on it in production.
    • ARM (aarch64) is not supported yet.
  • Root (or sudo) access.
  • A domain or subdomain pointed at the server's IP for the panel (e.g. panel.yourdomain.com).
  • At least 1 GB RAM for a small host; more as you add accounts.

One-line install

Sign in to your account, open the Dashboard, and copy the install command shown there — it already contains your license key:

curl -fsSL https://your-site/install.sh | sudo bash -s -- \
  --license NIMB-XXXX-XXXX-XXXX-XXXX \
  --server https://your-site

Replace https://your-site with your Nimbopanel account URL and NIMB-… with your key. The exact, ready-to-run command with your own key is shown on your Dashboard after you sign in.

The installer opens a short browser setup wizard (it prints a link and waits), where you confirm your license, create the admin account, and name the panel hostname. It then sets up the control panel, the web server, PHP, the mail stack, DNS, and the database services, and finishes by printing the panel URL and admin login.

Before you install (if you have a domain)

To get HTTPS automatically during install, do this first:

  1. Create an A record for your panel hostname (e.g. panel.yourdomain.com) pointing at your server's IP — plus ns1, ns2, and mail records if you'll host DNS/email.
  2. In your cloud firewall (DigitalOcean, Vultr, AWS, …), open ports 80 and 443.

No domain yet? You can install on the bare server IP and add a domain + HTTPS later.

After installing

  1. Open the panel URL and sign in with the admin credentials shown at the end of the install.
  2. HTTPS is automatic. If your panel hostname's DNS was already pointing at the server, the installer issues a real Let's Encrypt certificate for you — the final summary confirms it. If the domain wasn't pointed yet, the panel stays on http:// and HTTPS switches on by itself within ~5 minutes once you point the DNS. To force it immediately, SSH in as root and run sudo nimbopanel-enable-https.
  3. Create your first hosting account, or import an existing cPanel account — see Migrating from cPanel. Every hosting domain you add gets its own free Let's Encrypt certificate automatically once it points at the server.

Licensing and offline tolerance

Your server checks in with the license server from time to time. If it can't reach the license server — an outage, a network blip — your hosting keeps running. Nimbopanel is deliberately never "fail-closed". See How licensing works for the details.

Updating

Updates ship as a new release. Run the same installer again (or the built-in updater) to move to the latest version; your accounts and data are preserved.