jabali CLI reference: every command with flags

Last updated

The jabali binary is one Cobra root command with subcommands. Run it as root on the panel host. Most commands read the panel database and call the agent over /run/jabali/agent.sock.

This page groups the commands by area and shows the common tasks. The CLI reference lists every command and every flag. It is generated from the command tree, and CI fails when it drifts. jabali <command> --help gives the same detail on a box.

Global flags

  • --json: print JSON instead of text, where the command supports it.
  • --config <path>: the config file (default /etc/jabali/config.toml).

Command groups

Panel and updates

CommandWhat it does
jabali serveStart the Jabali Panel HTTP(S) server
jabali updatePull latest code, rebuild, migrate, and restart services
jabali repairDetect and fix known deployment-host issues
jabali versionPrint Jabali version, commit, and runtime info
jabali releaseRelease-channel management (stable/development)
jabali migrateDatabase migration commands
jabali retention-sweepPrune expired rows from unbounded log/report tables
jabali active-tasksShow running/queued tasks (updates, backups, malware scans)
jabali secretsRotate panel secrets after remediation (operator ceremony, run as root)
jabali settingsInspect and patch server settings (headless equivalent of /admin/settings)

Users and access

CommandWhat it does
jabali userManage panel users
jabali user-tokenManage a user’s API tokens (mint / list / revoke)
jabali sessionAudit and revoke active login sessions (Kratos)
jabali impersonationManage admin act-as impersonation grants (list / create / end)
jabali automation-tokenManage Automation API tokens (headless provisioning)
jabali ssoSSO (Single Sign-On) management commands
jabali sso-reapSweep stranded jabali-sso-.php files
jabali adminOperator-only administrative subcommands

Domains and web

CommandWhat it does
jabali domainManage hosted domains
jabali sslManage Let’s Encrypt SSL certificates
jabali panel-certManage the panel’s own TLS certificates (hostname + mail)
jabali page-templateManage error/index page templates
jabali phpPHP version + extension + per-user pool management
jabali php-defensePHP-defense (Snuffleupagus) status / mode / rules / incidents
jabali packageManage hosting packages
jabali limitsPer-user resource limits (cgroups v2 + POSIX quota + nginx)
jabali filesScoped tenant file manager (list/read/mkdir/move/chmod/archive/…) — same policy as the GUI
jabali disk-usageInspect / refresh a tenant’s disk-usage breakdown (files / email / databases)
jabali logInspect log types and mint/revoke log-stream access grants

DNS

CommandWhat it does
jabali dnsDNS zones and records (dns_zones / dns_records): list / add / update / delete
jabali pdnsPowerDNS helpers (recursor forwarders, etc.)

Mail

CommandWhat it does
jabali mailboxManage mailboxes (email via Stalwart)
jabali mailAdmin mail queue + outbound throttle management
jabali mail-certManage a domain’s mail TLS certificate (mail. SAN)
jabali mail-groupManage mail groups (distribution lists + shared-resource groups) and members
jabali shared-resourceManage shared mail resources — calendars, contacts, files
jabali panel-primaryManage the panel’s primary mail domain row

Databases, cron and SSH

CommandWhat it does
jabali dbManage user databases (mariadb / postgres)
jabali cronManage user cron jobs (systemd-user timers)
jabali ssh-keyManage user SSH authorized keys
jabali nspawnManage SSH sandbox nspawn images

Apps

CommandWhat it does
jabali appManage one-click app installs (direct DB)
jabali dockerManage the docker engine + app-marketplace host
jabali docker-appManage Docker app catalog installs (admin-only)
jabali python-appManage Python apps (admin-only)

Backups and recovery

CommandWhat it does
jabali backupBackup & restore subcommands (restic-backed)
jabali drDisaster-recovery standby: pair, status, promote

Security

CommandWhat it does
jabali crowdsecCrowdSec + AppSec operations (decisions, allowlists, hub, alerts, geoblock, captcha)
jabali appsecCrowdSec AppSec config operator subcommands
jabali apparmorAppArmor profile management operator commands
jabali aideAIDE file integrity monitor operator commands
jabali malwareMalware scan / quarantine / YARA / settings (incident response)
jabali malware-purgeHard-delete terminated malware quarantine rows past retention
jabali ufwUFW utilities (port baseline only; IP decisions live in CrowdSec)
jabali per-user-egressPer-user PHP-FPM egress firewall operator commands
jabali auditQuery, verify, and prune the unified audit log

Server

CommandWhat it does
jabali systemSystem information and services
jabali serviceAdmin service control (start/stop/restart/reload/enable/disable)
jabali ipAdmin IP address pool (managed_ips): list / add / update / delete
jabali notificationInspect notification channels and toggle event notifications

Common tasks

Get back into the panel

The installer prints the admin username and password at the end. If you lost them, set a new password, or print a one-click recovery link:

jabali user password <email|username|user-id>          # sets and prints a new password
jabali user password <email|username|user-id> --link   # prints a recovery URL (valid 24 h)
jabali user 2fa-reset <email|username|user-id>         # removes TOTP and recovery codes

Users and domains

jabali user list
jabali user create --username alice --email [email protected] --password-stdin
jabali user suspend <id> --reason "unpaid invoice"
jabali user unsuspend <id>
jabali domain list
jabali domain create --user alice --name example.com
jabali ssl enable example.com
jabali ssl renew example.com --force

Mail and databases

jabali mailbox create --domain example.com --local info    # prints the password if it generated one
jabali mailbox passwd [email protected]
jabali domain email-dkim-rotate example.com
jabali db create --user alice --name shop
jabali db user create --user alice --name shop
jabali db root-password                                     # rotates the MariaDB root password

Backups

jabali backup destination list
jabali backup destination test <id-or-name>                 # creates the restic repo if it is missing
jabali backup schedule list
jabali backup schedule run-now <id>
jabali backup account-restore --user alice --snapshot <id> --destination <name> --force

Updates, repair and support

jabali update                   # download the release, migrate and restart
jabali repair --diagnose        # list known host problems, change nothing
jabali repair --auto            # fix every non-destructive problem
jabali service status           # the units the panel watches
jabali system diagnostic        # upload an encrypted support bundle; prints a link and a password
jabali audit query --limit 100
jabali audit verify             # check the audit log's hash chain

Exit status

A command exits 0 on success. On any error it prints the error on stderr and exits 1.