CLI Reference

All litesoup commands — manage servers, sites, backups, users, and health checks from the terminal.

Stack Commands

# Install the full stack (Apache, PHP, MariaDB, Redis, ...)
litesoup stack install

# Install with an SSH key for the litesoup user (replaces root login)
litesoup stack install --ssh-key="ssh-ed25519 AAAA..."

# Update to the latest version
litesoup stack update

Site Commands

# Create a fresh site
litesoup site create --name=myapp --domain=example.com --tls=letsencrypt [email protected]

# Change an existing site's domain (ServerName + TLS + DB URLs only — the
# docroot keeps the app-name path; nothing is moved on disk)
litesoup site set-domain --name=myapp --new-domain=example.org

# Import an existing site (git repo + SQL dump)
litesoup site import --name=myapp --domain=example.com [email protected]:org/repo.git

# Delete a site and revoke its TLS cert
litesoup site delete --name=myapp

# Switch PHP version
litesoup site set-php --name=myapp --php=8.3

# Retune PHP-FPM pool size
litesoup site set-tier --name=myapp --tier=medium

# Change TLS mode
litesoup site set-tls --name=myapp --tls=letsencrypt [email protected]

# Set up Git webhook auto-deploy
litesoup site set-webhook --name=myapp

Since v0.10.8, site commands identify a site by its stable application --name (the on-disk identity: docroot, DB, cache keys and logs all derive from it). The domain is a separate network property and can be changed later with site set-domain without moving any files. The old --domain flag is kept as a backward-compatible alias.

Backup Commands

# Back up a site locally
litesoup backup site --domain=example.com

# Back up and also upload to S3
litesoup backup site --domain=example.com --dest=s3

# Restore from a backup
litesoup backup restore --domain=example.com --date=2026-07-15_043000

# List available backups
litesoup backup list --domain=example.com

# Run staggered backups for ALL sites (60s delay between each)
sudo bash /usr/lib/litesoup/backup/backup-stagger.sh --delay=60 --timeout=300

# Configure S3 destinations and email notifications
litesoup backup configure --s3-key=AKIA... --s3-secret=... --s3-bucket=my-backups

# Schedule daily backups
sudo bash /usr/lib/litesoup/backup/backup-install.sh --domain=example.com --schedule=daily

User Commands

# Create a client user with SSH + SFTP access and a site
litesoup user create \
  --name=client1 \
  --ssh-key="ssh-ed25519 AAAA..." \
  --domain=client1.com \
  --tls=letsencrypt [email protected]

# Create a user with SFTP only (no site)
litesoup user create --name=client1 --ssh-key="ssh-ed25519 AAAA..." --no-site

# List all managed users
litesoup user list

Status Command

# Quick server health dashboard (single line)
litesoup status

# With traffic info
litesoup status --verbose

# Watch mode (refresh every 2s)
litesoup status --watch=2

# ASCII mode (for headless/CI)
litesoup status --ascii

Harden Commands

litesoup harden firewall
litesoup harden fail2ban
litesoup harden ssh
litesoup harden apache
litesoup harden php
litesoup harden upgrades

Audit Commands

litesoup audit system
litesoup audit performance
litesoup audit wp-health --domain=example.com
litesoup audit wp-vulnerabilities --domain=example.com