shc events
shc events
Section titled “shc events”list recent system events; -f follows them live
Synopsis
Section titled “Synopsis”List the most recent events from the daemon, or view the audit chain with --audit.
Default mode prints the newest events and returns. -f/--follow instead opens an SSE connection and streams live events until interrupted; that form does not terminate on its own, which is why it has to be asked for. -n/--limit bounds the listing (default 100, max 1000).
shc events ls is the same listing under the name every other
inventory verb uses.
With --follow --since=
--audit instead queries the tamper-evident audit chain: historical records filtered by stack (global -s), tenant (global -t), event code, actor, or date range (--since/--until as YYYY-MM-DD or RFC 3339). -f/--follow polls for new records every 3 seconds.
shc events [flags]Examples
Section titled “Examples” shc events shc events ls -n 20 shc events -f -q --type docker -s myblog shc events -f --since 4210 shc events --audit --since 2026-06-01 --actor admin -n 50Options
Section titled “Options” --actor string with --audit: filter by actor -a, --all with --audit: drop the stack filter --audit view the audit chain instead of streaming live events --event string filter by event code -f, --follow stream live events until interrupted (this form does not terminate); with --audit: poll for new records every 3s -h, --help help for events -n, --limit int maximum records to show (listing and --audit; ignored with --follow) (default 100) --node string filter by node: its name or ID -q, --quiet hide noisy healthcheck events --since string with --follow: replay from sequence id; with --audit: start date (YYYY-MM-DD or RFC 3339) -T, --type string event types, comma-separated, or all; --event without -T reads every type (default "docker,audit,placement_bind,placement_move,placement_move_cleared,placement_retire") --until string with --audit: end date (YYYY-MM-DD or RFC 3339)Options inherited from parent commands
Section titled “Options inherited from parent commands” --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) -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") --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) -s, --stack string stack name (default: $SHC_STACK) -t, --tenant string tenant name (default: $SHC_TENANT) -v, --verbose verbose output (default: $SHC_VERBOSE)SEE ALSO
Section titled “SEE ALSO”- shc - Selfhosted Cloud CLI
- shc events ls - list the most recent events (alias for bare
shc events)