Reference

Server commands.

shis command and option reference.

Server command reference

Installed command is shis. shibumi-server remains compatible alias.

Setup#

shis                              Guided installation
shis setup                        Guided installation
shis init                         Install only, for automation
shis update                       Install latest stable release
shis uninstall [--purge] [--yes]

Apps#

shis list
shis add <domain> [--dry-run]
shis remove <domain|app-id> [--yes]

Explicit add requires repository, absolute checkout, and port:

shis add <domain> \
  --repository <github:owner/repo|GitHub URL> \
  --checkout <absolute-path> \
  --port <port> \
  [--ref <refs/heads/main>] \
  [--compose-file <path>] \
  [--compose-command <podman|podman-compose>] \
  [--service <name>] \
  [--health-path </healthz>] \
  [--dry-run] \
  [-- <test-command...>]

Deployment operations#

shis status <app-id> [--commit <full-sha>] [--json]
shis history <app-id> [--json]
shis rollback <app-id> <sha> [--yes]
shis caddy-cutover <app-id>

Rollback SHA accepts 7 to 40 lowercase hexadecimal characters and must resolve uniquely inside configured branch history.

Client handoff#

shis client-config <app-id> [--server-hostname <host>]
shis webhook-secret <app-id>

client-config prints commit-safe JSON. webhook-secret prints secret JSON only for explicit SSH handoff.

Service internals#

shis check --config <path>
shis serve --config <path>

serve is systemd entrypoint and skips npm update checks.