Reference

Command reference.

Commands and options available through shis.

shis commands

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

Setup#

text

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

Apps#

text

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

Explicit add needs repository, absolute checkout, and port:

text

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...>]

Deploys#

text

shis status <app-id> [--commit <full-sha>] [--json]
shis history <app-id> [--json]
shis logs <app-id>
shis rollback <app-id> [--yes]
shis redeploy <app-id> <full-sha>
shis image-load <app-id> <full-sha> <bytes>
shis deployment-mode <app-id> <build|prebuilt>
shis caddy-cutover <app-id>
shis caddy-refresh <app-id>

Rollback restores the one previous image kept for up to 12 hours and checks its health without building.

Client handoff#

text

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 commands#

text

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

systemd runs serve. It skips npm update checks.