Quickstart

Last updated

For brand-new hosts. Assumes Debian 13 (Trixie) or Ubuntu 24.04 (Noble), root, public IPv4, and DNS pointed at the box.

1. Install

curl -fsSL https://get.jabali-panel.com | sudo bash

On a terminal the installer asks which profile to install: Minimal, Web host, Mail server, Full, or Custom. Every install gets nginx, PHP-FPM (all current Sury versions), MariaDB, Redis, Kratos and the Jabali panel itself; the profile adds DNS, mail, security, quota and the rest. An install with no terminal defaults to Web host (DNS + security + quota), so mail is opt-in. See Choose what to install for the module list and unattended installs. End-to-end takes 8–15 minutes on a fresh VPS.

Override the upstream resolver if :53/udp outbound is blocked at the lab firewall. Put the variable after sudo, which drops the caller’s environment:

curl -fsSL https://get.jabali-panel.com | sudo JABALI_DNS_FORWARDER=192.168.1.1 bash

2. First login

The installer prints the panel URL, the admin username and a generated password at the end. Open the URL and sign in; you land in /jabali-admin/dashboard.

If you missed it, mint a Kratos recovery link for the admin account:

jabali user password <admin-username> --link

Or set a new password directly:

jabali user password <admin-email>

The recovery flow requires auth.kratos.admin_url configured (default: the local jabali-kratos admin socket). The installer wires this up; keep the socket reachable on the host.

3. Set the panel hostname

Server Settings → General → Panel Hostname. Pick the FQDN you want for the panel itself (e.g. panel.example.com). The reconciler will issue a Let’s Encrypt cert for it within ≤60 seconds and reload nginx + jabali-panel + jabali-webmail.

4. Create your first hosted user

Users → Create User. Pick a username, email, package (or “default”), and primary domain. The system creates:

  • A Linux account (login disabled, SFTP only).
  • A per-user PHP-FPM pool socket.
  • An nginx vhost for the primary domain.
  • A home directory under /home/<user> with quota.
  • Mail account + DKIM keys (if the domain runs mail).

5. Issue SSL for the domain

Domains → Edit → SSL → toggle on. The reconciler does HTTP-01 over the existing port-80 vhost within ≤60 seconds.

6. Add a database (optional)

Databases → Create. Pick MariaDB or PostgreSQL, set a DB user, get a password (shown once). Click “Open phpMyAdmin” to SSO into the DB UI.

7. Install WordPress (optional)

Applications → pick the domain → WordPress → Install. The wizard provisions the DB, downloads the latest WP, runs wp core install, and writes a single-use SSO drop-in (jabali-sso-<token>.php at the docroot, 60 s TTL, Installatron / Softaculous pattern) so the user one-clicks into /wp-admin/ from the panel.

You’re live.

Next