stats

Use stats when a script or operator needs the current public URL and runtime state for an active site. The command always prints pretty JSON. It combines the active context, plugin-declared ingress routes, Traefik router configuration, published host ports, and Docker container stats into one report. ingress.public_url is the primary application URL. Plugins may also return additional routes in ingress.routes, such as ArchivesSpace API/OAI endpoints or ISLE Fedora and IIIF endpoints. Each route includes a status so callers can tell whether the URL was resolved from Traefik or fell back to plugin defaults. The ingress.ports entries show the host port for Traefik’s HTTP and HTTPS entrypoints. If Traefik is running, the port reflects the live container binding. If the stack is powered off, state: "would_publish" shows the port Compose would publish if the project started right now.

Reference

Show ingress and container runtime stats for the active context

sitectl stats

Flag	Default	Description
`--format`	`json`	Output format. Only json is supported.
`--path`		Project path override

Common workflows

# Print the active context stats
sitectl stats

# Print stats for a checked-out project without switching contexts
sitectl stats --path .

# Read the primary public URL from JSON
sitectl stats --format json | jq -r '.ingress.public_url'

Getting started

Concepts

Commands

Reference

Common workflows

​Reference

​Common workflows

Reference

Common workflows