Deployments, services and containers
The HUD’s spine is tenant, environment, stack, deployment, service, container. This page walks down it and back up, and changes nothing.
$ tmux new -d -s hud -x 160 -y 44 shc hud$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[6] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ cloud prod prod nextcloud running home01 - open lan - ││ db prod prod postgres running home01 - open lan - ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ placed prod prod notes running home01 - open lan - ││ store prod prod /root/learn/versitygw running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>The :deployments table has the columns shc ls prints: STACK,
TENANT, ENV, APP, STATUS, NODE, LEASE, ACCESS, EXPOSURE
and REASON. ctrl-w adds the wide ones: READY, AGE, VERSION,
RUNTIME, ADDON, DISK, PROTECTED, MESSAGE, LATEST, HOSTS,
URL and ID. Press it again to narrow.
$ tmux send-keys -t hud C-w$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[6] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON READY AGE VERSION RUNTIME ADDON DISK PROTECTED MESSAGE LATEST HOS ││ cloud prod prod nextcloud running home01 - open lan - 4/4 6m latest - - - false - 34+10 - ││ db prod prod postgres running home01 - open lan - 1/1 12m latest - - - false - 16+16 - ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - 1/1 10m latest - - - false - - - ││ placed prod prod notes running home01 - open lan - 1/1 9m latest - - - false - - - ││ store prod prod /root/learn/versitygw running home01 - open lan - 1/1 6m latest - - - false - - - ││ web prod prod /root/learn/nginx running home01 - open lan - 1/1 12m latest - - - false - - - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud C-w/ filters the rows. Type part of a name and press Enter; the table keeps
the rows that match. ctrl-u clears the filter, and so does ctrl-q.
$ tmux send-keys -t hud '/' 'web' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud C-u '/' 'db' Enter C-qShift-N, Shift-A and Shift-S sort by the column that holds the name,
the age and the status; on this table those are STACK, AGE and
STATUS. Shift-O sorts by the column the cursor is on. ctrl-z keeps
only the rows in a bad state, which on a healthy cluster is none; press it
again to show everything.
$ tmux send-keys -t hud 'N'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[1] </db> ──────────────────────────────────────────────────────────────────┐│ STACK↓ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ db prod prod postgres running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud 'A' 'S' 'O' 'N'$ tmux send-keys -t hud C-z$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[1] </db> ──────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ db prod prod postgres running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud C-zd describes the focused row: the deployment’s record with the shc inspect bundle under it, the rendered compose file, its variables, plugs,
jobs and backup manifest, masked by the daemon. y is the same document as
YAML. esc closes either. Put the cursor on web first with the filter,
and let the table settle on it before pressing d.
$ tmux send-keys -t hud '/' 'web' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 1 node <n> Next Match Deployments: 9 (9 healthy) <shift-n> Prev Match Tenant: prod <r> Toggle Auto-Refresh Stack: all <x> Toggle Decode Environment: all <f> Toggle FullScreen shc9s Rev: 0.1.3┌───────────────────────────────────────────────────────────────── Describe(prod/prod/pgweb) ──────────────────────────────────────────────────────────────────┐│ app_digest: apppkg-v1:34d53be5edc0c9ab9754d6fbe91817f5811e753ac79dd08d8a516185f8e5d730 ││ app_identity: pgweb ││ app_name: /root/learn/pgweb ││ app_version: latest ││ created_at: 2026-10-11T09:16:19.151120415Z ││ desired: running ││ effective_access: open ││ effective_exposure: lan ││ environment: prod ││ has_host: false ││ id: 7 ││ inspect: ││ app: /root/learn/pgweb ││ containers: ││ - ID: 08cae2c09e22 ││ Image: sosedoff/pgweb:0.16.2 ││ Name: prod_prod_pgweb-pgweb-r0-pgweb-r0-1 ││ Node: node-3c94290c561f ││ Service: pgweb ││ State: running ││ Status: Up 8 minutes (healthy) ││ created_at: 2026-10-11T09:16:19.151120415Z ││ environment: prod ││ health_rollup: unknown ││ name: pgweb ││ node: node-3c94290c561f ││ original_compose: ││ content: ││ services: ││ pgweb: ││ image: sosedoff/pgweb:0.16.2 ││ environment: ││ PGWEB_DATABASE_URL: "postgres://{{ integrations.postgres.plug.data.username }}:{{ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'y'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy <m> Toggle ManagedFields Cluster: 1 node <n> Next Match Deployments: 9 (9 healthy) <shift-n> Prev Match Tenant: prod <r> Toggle Auto-Refresh Stack: all <x> Toggle Decode Environment: all <f> Toggle FullScreen shc9s Rev: 0.1.3┌─────────────────────────────────────────────────────────────────── YAML(prod/prod/pgweb) ────────────────────────────────────────────────────────────────────┐│ app_digest: apppkg-v1:34d53be5edc0c9ab9754d6fbe91817f5811e753ac79dd08d8a516185f8e5d730 ││ app_identity: pgweb ││ app_name: /root/learn/pgweb ││ app_version: latest ││ created_at: "2026-10-11T09:16:19.151120415Z" ││ desired: running ││ effective_access: open ││ effective_exposure: lan ││ environment: prod ││ has_host: false ││ id: 7 ││ inspect: ││ app: /root/learn/pgweb ││ containers: ││ - ID: 08cae2c09e22 ││ Image: sosedoff/pgweb:0.16.2 ││ Name: prod_prod_pgweb-pgweb-r0-pgweb-r0-1 ││ Node: node-3c94290c561f ││ Service: pgweb ││ State: running ││ Status: Up 8 minutes (healthy) ││ created_at: "2026-10-11T09:16:19.151120415Z" ││ environment: prod ││ health_rollup: unknown ││ name: pgweb ││ node: node-3c94290c561f ││ original_compose: ││ content: | ││ services: ││ pgweb: ││ image: sosedoff/pgweb:0.16.2 ││ environment: ││ PGWEB_DATABASE_URL: "postgres://{{ integrations.postgres.plug.data.username }}:{{ integrations.postgres.plug.data.password | urlencode }}@{{ int │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <yaml>$ tmux send-keys -t hud Escapec copies the row’s copy value. On a deployment that is its primary URL
when it has one, otherwise the row id, written to the clipboard through the
terminal. o opens that URL in a browser; web has no routed host, so it
has nothing to open and says so.
$ tmux send-keys -t hud 'c'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud 'o'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>Enter drills into a deployment’s services: one row per compose service with
its status, health, replicas, and live CPU and memory. Enter again on a
service lists its containers, the leaf. esc walks back up each time.
$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-f> Port-Forward <shift-x> Stop Cluster: 1 node <1> default <d> Describe <r> Restart <v> Views Deployments: 9 (9 healthy) <ctrl-j> Follow <s> Shell <y> YAML Tenant: prod <?> Help <shift-n> Sort Name Stack: all <ctrl-k> Kill <shift-s> Sort Status Environment: all <l> Logs <shift-w> Start shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌────────────────────────────────────────────────────────────────────── services(all)[1] ──────────────────────────────────────────────────────────────────────┐│ SERVICE↑ STACK ENV STATUS HEALTH REPLICAS CPU MEM ││ pgweb pgweb prod running healthy 1/1 0m↓ 8.5M ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <service>$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <s> Shell Cluster: 1 node <1> default <d> Describe <shift-n> Sort Name Deployments: 9 (9 healthy) <ctrl-j> Follow <shift-s> Sort Status Tenant: prod <?> Help <y> YAML Stack: all <m> Mount Environment: all <r> Restart shc9s Rev: 0.1.0┌───────────────────────────────────────────────────────────────────── containers(all)[1] ─────────────────────────────────────────────────────────────────────┐│ NAME↑ SERVICE STACK ENV STATE HEALTH ││ prod_prod_pgweb-pgweb-r0-pgweb-r0-1 pgweb pgweb prod running - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <service> <container>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud Escapev is the views picker: every table related to the focused row, each with
a letter. On a deployment they are s services, c containers, m
groups, l aliases, b backups, h schedules, j jobs, v volumes, k
secrets, g config, i integrations, n ingress, e events, a audit,
w exports, r retention and p placement. Each opens that table filtered to the row.
v then c is the one-hop route from a deployment to its containers.
b on the row itself, outside the picker, backs the deployment up now: it
asks for a name and whether to include its dependants, confirms shc backup create <stack>, and the new backup is listed under v then b.
$ tmux send-keys -t hud 'v'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ┌──────────────────────────────────────<Views>──────────────────────────────────────┐ ││ │ │ ││ │ (s) services this deployment's compose services │ ││ │ (c) containers this deployment's containers, every service │ ││ │ (m) groups this deployment's groups, one row a member │ ││ │ (l) aliases this deployment's aliases and the replicas each points at │ ││ │ (b) backups backups of this deployment │ ││ │ (h) schedules cron schedules on this deployment │ ││ │ (j) jobs jobs this deployment declares │ ││ │ (v) volumes volumes bound to this deployment │ ││ │ (k) secrets secrets of this deployment and of its stack │ ││ │ (g) config config set on this deployment and on its stack │ ││ │ (i) integrations plug/socket wiring this deployment is an endpoint of │ ││ │ (n) ingress the ingress routes the daemon wrote for this deployment │ ││ │ (e) events recent events about this deployment │ ││ │ (a) audit audit records about this deployment │ ││ │ (w) exports archives this deployment's exporters wrote │ ││ │ (r) retention the backup retention this deployment's stack resolves to │ ││ │ (p) placement why this deployment runs where it runs (shc constraint explain) │ ││ │ │ ││ └───────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud 'c'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <s> Shell Cluster: 1 node <1> default <d> Describe <shift-n> Sort Name Deployments: 9 (9 healthy) <ctrl-j> Follow <shift-s> Sort Status Tenant: prod <?> Help <y> YAML Stack: all <m> Mount Environment: all <r> Restart shc9s Rev: 0.1.0┌───────────────────────────────────────────────────────────────────── containers(all)[1] ─────────────────────────────────────────────────────────────────────┐│ NAME↑ SERVICE STACK ENV STATE HEALTH ││ prod_prod_pgweb-pgweb-r0-pgweb-r0-1 pgweb pgweb prod running - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <container>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'e'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <d> Describe Cluster: 1 node <1> default <ctrl-j> Follow Deployments: 9 (9 healthy) <?> Help Tenant: prod <l> Logs Stack: all <shift-s> Sort Status Environment: all <y> YAML shc9s Rev: 0.1.0┌────────────────────────────────────────────────────────────────────── events(all)[36] ───────────────────────────────────────────────────────────────────────┐│ SEQ↑ TIME LEVEL CODE TENANT STACK MESSAGE ││ 3667 18:40:55 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3668 18:40:55 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3669 18:40:55 INFO V200322EXCDIE prod pgweb container exec_die ││ 3712 18:41:05 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3713 18:41:05 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3714 18:41:05 INFO V200322EXCDIE prod pgweb container exec_die ││ 3751 18:41:15 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3752 18:41:15 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3753 18:41:15 INFO V200322EXCDIE prod pgweb container exec_die ││ 3793 18:41:25 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3794 18:41:25 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3795 18:41:25 INFO V200322EXCDIE prod pgweb container exec_die ││ 3838 18:41:35 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3839 18:41:35 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3840 18:41:35 INFO V200322EXCDIE prod pgweb container exec_die ││ 3877 18:41:45 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3878 18:41:45 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3879 18:41:45 INFO V200322EXCDIE prod pgweb container exec_die ││ 3919 18:41:55 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3920 18:41:55 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3921 18:41:55 INFO V200322EXCDIE prod pgweb container exec_die ││ 3964 18:42:05 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 3965 18:42:05 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 3966 18:42:06 INFO V200322EXCDIE prod pgweb container exec_die ││ 4003 18:42:16 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 4004 18:42:16 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 4005 18:42:16 INFO V200322EXCDIE prod pgweb container exec_die ││ 4045 18:42:26 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 4046 18:42:26 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info ││ 4047 18:42:26 INFO V200322EXCDIE prod pgweb container exec_die ││ 4090 18:42:36 INFO V200320EXCCRT prod pgweb container exec_create: curl -fsS http://127.0.0.1:8081/api/info ││ 4091 18:42:36 INFO V200321EXCSTR prod pgweb container exec_start: curl -fsS http://127.0.0.1:8081/api/info │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <event>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'p'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <d> Describe Cluster: 1 node <1> default <ctrl-j> Follow Deployments: 9 (9 healthy) <?> Help Tenant: prod <shift-n> Sort Name Stack: all <shift-s> Sort Status Environment: all <y> YAML shc9s Rev: 0.1.0┌───────────────────────────────────────────────────────────────────── placement(all)[6] ──────────────────────────────────────────────────────────────────────┐│ STEP↑ SOURCE OBJECT RULE FENCE NODE ││ condition condition ready takes new work - - ││ replica deployment prod/pgweb/prod - - node ││ rule integration postgres -> prod/db/prod share location (binding) - - ││ rule integration postgres -> prod/db/prod share location (holds this deployment to location=learn/home, where its provider can only run) - - ││ rule runtime docker - - - ││ rule runtime - - - - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <placement>:placement is why the deployment runs where it runs, the same answer
shc constraint explain prints, one row per step. Walk the rest of the
picker the same way: m, l, b, h, j, v, k, g, i, n,
a, w and r. A deployment with no group lists no member under m,
and one that declares no alias lists nothing under l.
$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'm' Escape$ tmux send-keys -t hud 'v' 'l' Escape$ tmux send-keys -t hud 'v' 'b' Escape$ tmux send-keys -t hud 'v' 'h' Escape$ tmux send-keys -t hud 'v' 'j' Escape$ tmux send-keys -t hud 'v' 'v' Escape$ tmux send-keys -t hud 'v' 'k' Escape$ tmux send-keys -t hud 'v' 'g'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help Cluster: 1 node <1> default <c> Copy <shift-a> Sort Age Deployments: 9 (9 healthy) <ctrl-d> Delete <shift-n> Sort Name Tenant: prod <d> Describe <y> YAML Stack: all <e> Edit Environment: all <ctrl-j> Follow shc9s Rev: 0.1.0┌─────────────────────────────────────────────────────────────────────── config(all)[0] ───────────────────────────────────────────────────────────────────────┐│ PATH↑ VALUE SCOPE ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <config>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'i' Escape$ tmux send-keys -t hud 'v' 'n' Escape$ tmux send-keys -t hud 'v' 'a' Escape$ tmux send-keys -t hud 'v' 'w' Escape$ tmux send-keys -t hud 'v' 'r'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Set Cluster: 1 node <1> default <t> Apply <shift-n> Sort Name Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <ctrl-j> Follow Stack: all <?> Help Environment: all <ctrl-d> Reset shc9s Rev: 0.1.0┌───────────────────────────────────────────────────────────────────── retention(all)[4] ──────────────────────────────────────────────────────────────────────┐│ TIER↑ KEEP SCOPE ││ daily 7 stack pgweb ││ monthly 12 stack pgweb ││ weekly 4 stack pgweb ││ yearly 5 stack pgweb ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <retention>$ tmux send-keys -t hud EscapeA column that names another table’s row is a link. ctrl-j follows it:
on :deployments the TENANT column lands on :tenants and NODE on
:nodes. A row with one link jumps straight through; a row with two puts
up a picker, Down and Enter pick the node. On every per-deployment table
the TENANT or NODE column leads out the same way.
$ tmux send-keys -t hud C-j$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: prod <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌───────────────────────────────────────────────────────────────── deployments(all)[2] </web> ─────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ┌────────<Follow>─────────┐ ││ │ │ ││ │ TENANT → tenants/prod │ ││ │ NODE → nodes/home01 │ ││ │ │ ││ └─────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud Down Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help <shift-s> Sort Status Cluster: 1 node <1> default <shift-k> Cordon <ctrl-d> Leave <v> Views Deployments: 9 (9 healthy) <d> Describe <l> Logs <y> YAML Tenant: prod <shift-d> Drain <e> Set-Public-Address Stack: all <ctrl-j> Follow <shift-a> Sort Age Environment: all <ctrl-k> Forget <shift-n> Sort Name shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌────────────────────────────────────────────────────────────────── nodes(all)[1] </home01> ───────────────────────────────────────────────────────────────────┐│ NAME↑ STATE CONDITION AVAIL CLOUD LOCATION ROOM BUILD LEADER VOTER ││ home01 healthy ready active learn learn/home ok 0.1.0-rig.20261010224631.11e316f8fa true true ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> <node>$ tmux send-keys -t hud EscapeThe three facet tables sit above deployments, and all three work the same
way. :tenants lists the tenants: u on a row makes it the session’s
tenant, and Enter makes it the session’s tenant and opens its deployments.
:environments and :stacks are the same shape for the other two axes:
u selects the row’s value and Enter selects it and opens the deployments
that carry it. The number keys switch environment from any table: 0 is
every environment, 1 to 9 the recent ones.
$ tmux send-keys -t hud ':tenants' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <u> Use Cluster: 1 node <1> default <ctrl-d> Delete <v> Views Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <shift-n> Sort Name shc9s Rev: 0.1.0┌────────────────────────────────────────────────────────────────────── tenants(all)[2] ───────────────────────────────────────────────────────────────────────┐│ ACTIVE NAME↑ STACKS ││ false master 3 ││ false prod 6 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant>$ tmux send-keys -t hud 'u'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <u> Use Cluster: 1 node <1> default <ctrl-d> Delete <v> Views Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: master <?> Help Stack: all <ctrl-n> New Environment: all <shift-n> Sort Name shc9s Rev: 0.1.0┌────────────────────────────────────────────────────────────────────── tenants(all)[2] ───────────────────────────────────────────────────────────────────────┐│ ACTIVE NAME↑ STACKS ││ false master 3 ││ false prod 6 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant>$ tmux send-keys -t hud 'j' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: master <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[6] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ cloud prod prod nextcloud running home01 - open lan - ││ db prod prod postgres running home01 - open lan - ││ pgweb prod prod /root/learn/pgweb running home01 - open lan - ││ placed prod prod notes running home01 - open lan - ││ store prod prod /root/learn/versitygw running home01 - open lan - ││ web prod prod /root/learn/nginx running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant> <deployment>$ tmux send-keys -t hud ':environments' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <ctrl-d> Delete Cluster: 1 node <1> default <d> Describe Deployments: 9 (9 healthy) <e> Edit Tenant: master <?> Help Stack: all <u> Use Environment: all <y> YAML shc9s Rev: 0.1.0┌──────────────────────────────────────────────────────────────────── environments(all)[3] ────────────────────────────────────────────────────────────────────┐│ NAME↑ ACTIVE KEY ││ all * 0 ││ default 1 ││ prod ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <environment>$ tmux send-keys -t hud 'u' ':stacks' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <ctrl-d> Delete Cluster: 1 node <1> default <d> Describe Deployments: 9 (9 healthy) <e> Edit Tenant: master <?> Help Stack: all <u> Use Environment: all <y> YAML shc9s Rev: 0.1.0┌────────────────────────────────────────────────────────────────────── stacks(all)[10] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ ACTIVE KEY ││ all * ││ cloud ││ db ││ keycloak ││ pgweb ││ placed ││ postgres ││ store ││ traefik ││ web ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <stack>$ tmux send-keys -t hud 'u' Enter '0' '1' '2' '0'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: master <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[3] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ keycloak master default keycloak running home01 - open lan - ││ postgres master default postgres running home01 - open lan - ││ traefik master default traefik running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <stack> <deployment>Rows can be marked. space marks the focused row, ctrl-space marks a
range from the last mark, ctrl-\ clears every mark. ctrl-s writes the
table to a file under the HUD’s config directory, with secret columns
masked, and ctrl-p writes the HUD’s own settings to disk so they survive
the next start.
$ tmux send-keys -t hud ':deployments' Enter 'g' Space 'j' 'j' C-Space$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: master <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[3] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ keycloak master default keycloak running home01 - open lan - ││ postgres master default postgres running home01 - open lan - ││ traefik master default traefik running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment>$ tmux send-keys -t hud 'C-\' C-s$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <w> Export <ctrl-n> New <s> Shell <v> V… Cluster: 1 node <1> default <b> Backup <ctrl-j> Follow <o> Open <shift-a> Sort Age <y> YA Deployments: 9 (9 healthy) <shift-c> Clone <?> Help <shift-f> Port-Forward <shift-n> Sort Name Tenant: master <c> Copy <ctrl-k> Kill <p> Protect <shift-s> Sort Status Stack: all <d> Describe <shift-l> Lease <shift-p> Repoint <shift-w> Start Environment: all <e> Edit <l> Logs <r> Restart <shift-x> Stop shc9s Rev: 0.1.0-rig.20261010224631.11e316f8fa┌──────────────────────────────────────────────────────────────────── deployments(all)[3] ─────────────────────────────────────────────────────────────────────┐│ STACK↑ TENANT ENV APP STATUS NODE LEASE ACCESS EXPOSURE REASON ││ keycloak master default keycloak running home01 - open lan - ││ postgres master default postgres running home01 - open lan - ││ traefik master default traefik running home01 - open lan - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <deployment> 😎 File saved successfully: "deployments-all-1791692926786175656.csv"$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-p C-cThis page changed nothing on the cluster. The next page changes things under the HUD and watches it move.