Skip to content
SHC Docs

shc logs

view deployment logs

View logs for the deployment named with --stack (or the active context’s stack). An optional positional service narrows output to one service. --follow streams new lines as they arrive; --since accepts a timestamp or a relative duration (e.g. 1h); --tail limits how many trailing lines are shown. --all iterates every running deployment in the tenant instead of one stack.

On an incus node a line’s time is the moment the node read it from the console, as the write lands. Lines a console held before the node first read it have no time: --timestamps prints them without one, and no --since window holds them.

shc logs [service] [flags]
shc logs -s myblog
shc logs -s myblog -f -n 100
shc logs web -s myblog --since 1h --timestamps
shc logs --all
--all show logs for all deployments in the tenant
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
-f, --follow follow log output
-h, --help help for logs
--no-color disable ANSI colors
--since string show logs since (timestamp or duration)
-s, --stack string stack name
-n, --tail int number of lines to show from end
--timestamps show timestamps
--where string selector of the replicas whose logs to read
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc - Selfhosted Cloud CLI