Skip to content
SHC Docs

Stack commands

All stack-scoped commands take the stack either positionally (shc start nextcloud) or via the global -s/--stack flag (shc -s nextcloud start). Service-level operations use -S/--service.

List deployments (one row per stack + environment), including status and node binding:

Terminal window
shc ls
shc -o json ls

For per-deployment detail use shc inspect (on-disk + rendered configuration) and shc status (health, per-service counts).

Start stack services:

Terminal window
shc start nextcloud # positional stack
shc -s nextcloud start # global -s
shc -s nextcloud start -S web # one service only

Stop stack services:

Terminal window
shc stop nextcloud
shc -s nextcloud stop -f # kill instead of graceful stop
shc -s nextcloud stop -S web # one service only

Restart services:

Terminal window
shc restart nextcloud
shc -s nextcloud restart -S web

Execute non-interactive command (stack from ctx, service via -S, then -- and the command):

Terminal window
shc -s nextcloud exec -S web -- ls -la
shc -s nextcloud exec -S web -w /app -- cat config.php
shc -s nextcloud exec -S web -u www-data -- whoami

Interactive shell access:

Terminal window
shc -s nextcloud shell
shc -s nextcloud shell -S web
shc -s nextcloud shell -S web -u www-data

View container logs:

Terminal window
shc -s nextcloud logs
shc -s nextcloud logs --follow
shc -s nextcloud logs -S web --since 1h
shc -s nextcloud logs --tail 100

Health status:

Terminal window
shc status
shc -s nextcloud status
shc status --all