See what is running, what is not, and why. nself status gives you an instant health overview — or a deep diagnostic when you need one.
# Overview of all services
nself status
# Focus on one service
nself status hasura
# Watch mode — refreshes every 5 seconds
nself status --watch
# Machine-readable output for scripts
nself status --jsonnself status [SERVICE] [FLAGS]Without arguments, nself status prints a compact table of every service in your stack with its running state, uptime, and a one-line health verdict. The default view covers required services, enabled optional services, and installed plugins.
Pass a service name to narrow the output to that service — useful when you are debugging a specific component. Flags let you adjust detail level, refresh rate, and output format.
| Argument | Description |
|---|---|
SERVICE | Optional. One of: postgres, hasura, auth, nginx, storage, redis, functions, mail, search, admin, or any installed plugin name |
| Flag | Type | Default | Description |
|---|---|---|---|
--resources | bool | false | Include CPU %, memory usage, and disk I/O for each container |
--watch | bool | false | Refresh output on an interval (default 5s) |
--interval | int | 5 | Refresh interval in seconds when using --watch |
--json | bool | false | Output as JSON (one object per service) |
--quiet | bool | false | Print only a single line: OK or DEGRADED |
--all | bool | false | Include disabled optional services (shown as off) |
--verbose | bool | false | Show container IDs, image tags, and port bindings |
--deep | bool | false | Extended health: Postgres query round-trip, Hasura metadata reload, Auth session issue, plugin reachability probes |
nself status
# SERVICE STATE UPTIME HEALTH
# postgres running 3d 14h OK
# hasura running 3d 14h OK
# auth running 3d 14h OK
# nginx running 3d 14h OK
# redis running 3d 14h OK
# storage running 3d 14h OK
# mail running 3d 14h OK
# ai (plugin) running 3d 14h OK--deep runs additional round-trip probes beyond simple container state checks:
| Probe | What it checks |
|---|---|
| Postgres query | Executes SELECT 1 and measures round-trip latency |
| Hasura metadata | Calls the Hasura metadata API and verifies it responds |
| Auth session | Issues and immediately revokes a test session token |
| Plugin reachability | Sends an HTTP health ping to each running plugin's port |
| Cert expiry | Checks TLS certificate expiry for all configured domains |
nself status --deep
# postgres running OK (query: 1.2ms)
# hasura running OK (metadata: 14ms)
# auth running OK (session: 8ms)
# ai (plugin) running OK (ping: 3ms)
# nginx running OK (cert: 87 days remaining)nself status --watch --resources --interval 2nself status postgres --quiet
# OK
# Use exit code in a script
nself status postgres --quiet && echo "DB up" || echo "DB down"nself status --json --all | jq '.[] | select(.state != "running")'0 — all checked services are running and healthy1 — one or more services are stopped, crashed, or failing health probes2 — invalid arguments or the stack is not configured