Browse documentation
Reference

CLI reference

The everyday commands for serving, inspecting and maintaining UWAS.

UWAS v0.11.31Release notes reviewed October 22, 2026Upstream reference

Serve and inspect

Start with an explicit configuration or let the first-run flow create one. Use version and status to inspect the installed binary and running server. Run help for the complete command list and current options.

Terminalshell
uwas version
uwas serve -c uwas.yaml
uwas status
uwas help

Validate and reload

Validate a specific configuration before applying changes. The config test command also lists loaded domains. Reload asks the running server to apply configuration changes.

Terminalshell
uwas config validate -c uwas.yaml
uwas config test -c uwas.yaml
uwas reload

Inspect the platform

These commands expose domain, certificate, cache, PHP and user information through the administration interface. The CLI can load its API key from ~/.uwas/.env.

Terminalshell
uwas domain list
uwas cert list
uwas cache stats
uwas php list
uwas user list
uwas doctor

Manage the lifecycle

Use stop and restart for the running instance. Installing and uninstalling the systemd service is a Linux administration workflow. Review the command help before operations that change service state.

Terminalshell
uwas restart
uwas stop

# Linux systemd setup
sudo uwas install
sudo systemctl start uwas
Need every option? Read the complete configuration reference and the upstream upgrade notes for your release.