Every other table
The last three pages covered deployments, nodes and what hangs off them.
This page opens every other table once, presses every key it binds and
opens every verb in its a menu, so nothing in the HUD is left untyped.
Where a verb would change something you do not want changed, its form or
its confirm is read and left with esc; where it is safe, it is
confirmed. Two keys open an editor instead of a form: e on a row whose
settings are a document, and ctrl-n on a table whose new row is one,
hand a YAML template to $EDITOR. Debian leaves $EDITOR unset, and the
HUD then opens the system’s editor. This page names vi for the HUD’s
session so its steps read the same on every machine, and leaves vi with
:q! so nothing is written. A ctrl-n template left that way creates
nothing: the HUD returns to the table and its status line says so. A
table that holds no row on this cluster is opened and read, and its
row keys are named and not pressed: a key with no row under it does
nothing, and an esc with nothing to close leaves the table.
$ tmux new -d -s hud -x 160 -y 44 -e EDITOR=vi shc hudApps, add-ons and repos
Section titled “Apps, add-ons and repos”:apps is the catalogue, shc catalog ls. d is the app with its
compiled install plan, i opens the install form, Enter lists the app’s
add-ons. Filtered on nextcloud the table holds monica-nextcloud, then
nextcloud; the cursor is on the first row again each time a view
returns, so j comes before each key that acts on nextcloud.
:addons has i too; a vapp add-on refuses and names the command. :repos lists the catalogues: its menu holds sync and
delete, ctrl-d is the delete, e opens the repo’s document and
ctrl-n a template for a new one.
$ 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: 2 nodes <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.2┌──────────────────────────────────────────────────────────────────── 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>$ tmux send-keys -t hud ':apps' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <i> Install Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── apps(all)[102] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ KIND VERSION REPO NODES DESCRIPTION ││ activepieces app 0.88+0 shc - Workflow automation with a visual flow builder and TypeScri… ││ affine app 0.27+5 shc - AFFiNE - open source knowledge base and wiki (Notion altern… ││ affine-rs app 1.0+7 shc - AFFiNE on a seat-cap-free Rust server - the MIT v0.27.3 cli… ││ agent-canvas app 1.10+1 shc - OpenHands Agent Canvas - self-hosted control plane for codi… ││ blockscout app 9.0.2+2 shc - Open-source block explorer for EVM-compatible blockchains (… ││ ciso app 3.20.8+2 shc - CISO Assistant - open-source GRC platform for cybersecurity… ││ ciso-assistant app 3.20.8+2 shc - CISO Assistant - open-source GRC platform for cybersecurity… ││ clickhouse app 26.3+0 shc - ClickHouse - fast open-source column-oriented DBMS for anal… ││ crowdsec app 1.7+0 shc - CrowdSec is a collaborative, open source intrusion detectio… ││ defectdojo app 3.2+3 shc - DefectDojo is a vulnerability management and security orche… ││ defectdojo-classic app 2.58+3 shc - DefectDojo vulnerability management, the classic 2.58 line … ││ dependency-track app 5.0+4 shc - OWASP Dependency-Track is an intelligent component analysis… ││ dify app 1.16+5 shc - Dify - LLM app development platform. Visual workflow builde… ││ docuseal app 3.1+3 shc - DocuSeal - open source DocuSign alternative for digital doc… ││ ethereum app 1.17+1 shc - Full Ethereum node (Geth + Lighthouse) providing JSON-RPC e… ││ external-gitlab app 1.0+1 shc - Headless GitLab front for an instance this estate does not … ││ external-imap app 1.0+1 shc - Headless IMAP front for an external mailbox. Serves the `im… ││ external-llm app 1.0+1 shc - Headless LLM front for an external inference provider. Serv… ││ external-mongodb app 1.0+1 shc - Headless MongoDB front for an external/managed cluster. Ser… ││ external-mysql app 1.0+1 shc - Headless MySQL/MariaDB front for an external/managed instan… ││ external-oidc app 1.0+1 shc - Headless SSO front for an external OpenID Connect provider.… ││ external-postgres app 1.0+1 shc - Headless PostgreSQL front for an external/managed instance.… ││ external-redis app 1.0+1 shc - Headless Redis front for an external/managed instance. Serv… ││ external-s3 app 1.0+1 shc - Headless ADOPT-ONLY front for a bucket that already exists … ││ external-smtp app 1.0+2 shc - Headless SMTP front for an external mail provider. Serves t… │...│ fleet app 4.90+8 shc - Open-source device management platform with MDM and osquery ││ frappe app 15.118+8 shc - Frappe framework with ERPNext - full-featured business appl… ││ fusionpbx app 4.2.2+0 shc - FusionPBX unified communications platform with FreeSWITCH t… ││ gitea app 1.27+3 shc - Gitea is a lightweight self-hosted Git service with issue t… ││ gitlab app 18.11+7 shc - GitLab - complete DevSecOps platform ││ gitlab-huly app 0.2+2 shc - One-way GitLab to Huly bridge. Merge requests appear as ref… │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <app>$ tmux send-keys -t hud '/' 'nextcloud' Enter$ tmux send-keys -t hud 'j'$ tmux send-keys -t hud 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌────────────────────────────────────────────────────────────────── Describe(shc/nextcloud) ───────────────────────────────────────────────────────────────────┐│ fields: ││ CATEGORY: collaboration ││ DESCRIPTION: Nextcloud - self-hosted productivity and collaboration plat… ││ HIDDEN: - ││ HIDDEN-REASON: - ││ HOMEPAGE: https://nextcloud.com ││ KIND: app ││ NAME: nextcloud ││ NODES: - ││ PARENT: - ││ REPO: shc ││ SOURCE: https://selfhostedcloud.org/apps/0.1/nextcloud/34+9/nextcloud-15f98d05e582.app ││ TAGS: collaboration,files,sync,office,groupware ││ VAPP: false ││ VERSION: 34+9 ││ id: shc/nextcloud ││ source: list row (this type has no per-item detail route on this daemon) ││ type: apps ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <app> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'j'$ tmux send-keys -t hud 'i'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <i> Install Environment: all <shift-n> Sort Name shc9s Rev: 0.1.0 ┌───────────<install nextcloud from shc 1/11>───────────┐┌──────────────────────────────────────────────────│ │───────────────────────────────────────────────────┐│ NAME↑ KIND VERSION │ Nextcloud - self-hosted productivity and │ ││ monica-nextcloud app 0.1+1 │ collaboration platform │xtcloud mirror of contacts as a CardDAV… ││ nextcloud app 34+8 │ stack: the deployment's name (-s); nextcloud │ted productivity and collaboration plat… ││ │ otherwise │ ││ │ environment: which environment to install into (-e) │ ││ │ version: a version other than the catalogue's newest │ ││ │ (34) │ ││ │ route: HTTP routes, comma-separated: │ ││ │ hostname[/path][=service[:port]] (--expose) │ ││ │ port: published ports, comma-separated: external[+ │ ││ │ udp][@conn][=service[:container]] (--expose) │ ││ │ integrate: integrations, comma-separated: │ ││ │ plug=provider[@env] (-i) │ ││ │ public: reachable from the internet, not only the LAN │ ││ │ (--public) │ ││ │ gated: Keycloak SSO in front of the app (--gated) │ ││ │ │ ││ │ stack: │ ││ │ environment: prod │ ││ │ version: │ ││ │ route: │ ││ │ port: │ ││ │ integrate: │ ││ │ public: │ ││ │ gated: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <app>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'j'$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <y> YAML Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <i> Install Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── addons(all)[46] ───────────────────────────────────────────────────────────────────────┐│ ADDON↑ VERSION VERSIONS DESCRIPTION ││ appointments latest 1 book appointments into your calendar through a secure onlin… ││ approval latest 1 let users approve or reject files ││ bookmarks latest 1 sync browser bookmarks ││ calendar latest 1 CalDAV-based calendar management ││ checksum latest 1 compute a hash checksum of a file ││ contacts latest 1 CardDAV address book ││ deck latest 1 kanban-style project management ││ drawio latest 1 create and edit draw.io diagrams and whiteboards in Nextclo… ││ external latest 1 add launcher links that open or embed a URL outside Nextclo… ││ externalpassword latest 1 send users to an external site to change their password (no… ││ extract latest 1 on-the-fly archive extraction (Nextcloud 27 maximum, dead u… ││ files_accesscontrol latest 1 block access to files by rule ││ files_archive latest 1 on-the-fly archive inspector (no store release above Nextcl… ││ files_automatedtagging latest 1 assign collaborative tags to files by rule ││ files_fulltextsearch latest 1 index the content of files (needs fulltextsearch plus a sea… ││ files_fulltextsearch_tesseract latest 1 OCR indexing for image content (no store release above Next… ││ files_linkeditor latest 1 read and edit .URL and .webloc files ││ files_lock latest 1 WebDAV file locking (store app up to Nextcloud 33; server-s… ││ files_zip latest 1 create zip archives from files in place ││ forms latest 1 surveys and questionnaires ││ fulltextsearch latest 1 core of the full-text search framework (a platform app supp… ││ group_everyone latest 1 a virtual group that contains every account ││ groupfolders latest 1 shared admin-managed folders ││ guests latest 1 restricted guest accounts that can only see what is shared … ││ integration_docuseal latest 1 request and track electronic signatures on Files documents … ││ integration_paperless latest 1 send Files documents to a self-hosted Paperless-ngx documen… ││ mail latest 1 IMAP/SMTP web mail client ││ metadata latest 1 show EXIF and other file metadata (no store release above N… ││ news latest 1 RSS/Atom feed reader ││ notes latest 1 distraction-free note-taking ││ onlyoffice latest 1 open office documents in a collaborative editor served by a… ││ otpmanager latest 1 manage TOTP and HOTP codes inside Nextcloud │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <app> <addon>$ tmux send-keys -t hud 'i'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <y> YAML Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <i> Install Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── addons(all)[46] ───────────────────────────────────────────────────────────────────────┐│ ADDON↑ VERSION VERSIONS DESCRIPTION ││ appointments latest 1 book appointments into your calendar through a secure onlin… ││ approval latest 1 let users approve or reject files ││ bookmarks latest 1 sync browser bookmarks ││ calendar latest 1 CalDAV-based calendar management ││ checksum latest 1 compute a hash checksum of a file ││ contacts latest 1 CardDAV address book ││ deck latest 1 kanban-style project management ││ drawio latest 1 create and edit draw.io diagrams and whiteboards in Nextclo… ││ external latest 1 add launcher links that open or embed a URL outside Nextclo… ││ externalpassword latest 1 send users to an external site to change their password (no… ││ extract latest 1 on-the-fly archive extraction (Nextcloud 27 maximum, dead u… ││ files_accesscontrol latest 1 block access to files by rule ││ files_archive latest 1 on-the-fly archive inspector (no store release above Nextcl… ││ files_automatedtagging latest 1 assign collaborative tags to files by rule ││ files_fulltextsearch latest 1 index the content of files (needs fulltextsearch plus a sea… ││ files_fulltextsearch_tesseract latest 1 OCR indexing for image content (no store release above Next… ││ files_linkeditor latest 1 read and edit .URL and .webloc files ││ files_lock latest 1 WebDAV file locking (store app up to Nextcloud 33; server-s… ││ files_zip latest 1 create zip archives from files in place ││ forms latest 1 surveys and questionnaires ││ fulltextsearch latest 1 core of the full-text search framework (a platform app supp… ││ group_everyone latest 1 a virtual group that contains every account ││ groupfolders latest 1 shared admin-managed folders ││ guests latest 1 restricted guest accounts that can only see what is shared … ││ integration_docuseal latest 1 request and track electronic signatures on Files documents … ││ integration_paperless latest 1 send Files documents to a self-hosted Paperless-ngx documen… ││ mail latest 1 IMAP/SMTP web mail client ││ metadata latest 1 show EXIF and other file metadata (no store release above N… ││ news latest 1 RSS/Atom feed reader ││ notes latest 1 distraction-free note-taking ││ onlyoffice latest 1 open office documents in a collaborative editor served by a… ││ otpmanager latest 1 manage TOTP and HOTP codes inside Nextcloud │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <app> <addon>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':repos' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 531 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud 'a'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 531 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ││ ││ ││ ┌───────────────────────────────────────────<Actions>───────────────────────────────────────────┐ ││ │ │ ││ │ <t> sync pull the catalogue now (shc repo sync) │ ││ │ <ctrl-d> delete remove the repo and its catalogue entries (shc repo rm) │ ││ │ │ ││ └───────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 531 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ┌────────────────────────<sync>─────────────────────────┐ ││ │ │ ││ │ pull the catalogue now (shc repo sync) │ ││ │ force: re-read every app even when nothing changed │ ││ │ upstream │ ││ │ │ ││ │ force: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 531 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ┌─────────<Confirm Write repos/system/system/shc>──────────┐ ││ │ │ ││ │ Run sync on repos/system/system/shc │ ││ │ │ ││ │ pull the catalogue now (shc repo sync) │ ││ │ │ ││ │ force: false │ ││ │ │ ││ │ Provider will run: │ ││ │ shc repo sync shc --tenant system --environment system │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └──────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 542 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud 'e'$ tmux capture-pane -pt hud# x9s: editing repos/system/system/shc. Save to apply, quit unchanged to abort.app_count: 460created_at: "2026-10-09T08:09:32.737125712Z"environment: systemid: 2name: shcpriority: 50synced_at: "2026-10-09T08:43:13.722155789Z"tenant_name: systemupdated_at: "2026-10-09T08:43:13.722155789Z"url: https://selfhostedcloud.org/apps/0.1/index.yaml~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-3416177906.yaml" 11L, 351B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 542 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing repos/new. Save to apply, quit unchanged to abort.# A new app repo: "shc repo add" as a document. A repo is a catalogue# shc syncs app definitions from; what it contributes shows up in :apps.## The repo is added to the TENANT you are browsing (:tenants, "u" to# switch).
# name: what to call it locally. REQUIRED: it is what "sync" and "rm"# address, and what the REPO column on :apps shows.name: ""
# url: where to sync from. REQUIRED. A git remote, or whatever the adapter# below understands.url: ""
# token: a credential for a private repo. Stored by the daemon; never# echoed back in the confirmation or the mutation history.# token: ""
# priority: which repo wins when two carry an app of the same name.# Higher wins. Defaults to 0.# priority: 10
# sync_interval: how often the daemon re-syncs on its own, e.g. "1h".# Leave it unset to sync only when asked (the "sync" action on the row).# sync_interval: 1h
# adapter: how to read the source. Leave unset for shc's native layout.# adapter: ""
# environment: the environment this repo is scoped to. Defaults to# "default"; a repo is addressed within (tenant, environment) like# everything else here.# environment: default~~~~~~~~~"/tmp/x9s-edit-3742470375.yaml" 34L, 1217B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 542 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-a> Sort Age Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <t> Sync Stack: all <ctrl-j> Follow <v> Views Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── repos(all)[2] ────────────────────────────────────────────────────────────────────────┐│ NAME↑ URL ADAPTER APP COUNT PRIORITY TENANT NAME ││ shc https://selfhostedcloud.org/apps/0.1/index.yaml - 542 50 system ││ shipped shipped://apps - 2 10 system ││ ││ ││ ││ ┌──────────<Confirm Write repos/system/system/shc>──────────┐ ││ │ │ ││ │ Run delete on repos/system/system/shc │ ││ │ │ ││ │ remove the repo and its catalogue entries (shc repo rm) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc repo rm shc --tenant system --environment system -y │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └───────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <repo>$ tmux send-keys -t hud EscapeBackups, mounts, volumes, storage and exports
Section titled “Backups, mounts, volumes, storage and exports”:backups is shc backup ls across the tenant. Its menu holds restore,
verify, mount, export and delete; w is the export and ctrl-d
the delete, ctrl-n opens a template that takes one. The first row is
the oldest backup the app ladder left. Read its restore form, verify it,
then mount it.
$ tmux send-keys -t hud ':backups' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured - none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud 'g' 'a'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured - none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ││ ││ ┌───────────────────────────────────────────────────────────<Actions>────────────────────────────────────────────────────────────┐ ││ │ │ ││ │ <shift-r> restore restore this archive over the deployment (shc backup restore) │ ││ │ <shift-v> verify re-read the archive and check it against its manifest (shc backup verify) │ ││ │ <m> mount mount the archive read-only on the daemon host (shc backup mount); :mounts carries the path and the umount │ ││ │ <ctrl-d> delete delete the archive (shc backup rm) │ ││ │ <w> export write the archive to a file on this machine (shc backup export) │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured - none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - ┌───────────────────────<restore>───────────────────────┐ assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - │ │ assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - │ restore this archive over the deployment (shc backup │ assured - restic home01 ││ │ restore) │ ││ │ strategy: how to reconcile with what is there now │ ││ │ create_rollback: snapshot the current state first, so │ ││ │ restoring that snapshot can undo this │ ││ │ keep_running: restore without stopping the deployment │ ││ │ only safe for file-only archives │ ││ │ force: restore even when shc judges the archive a │ ││ │ poor match │ ││ │ │ ││ │ strategy: replace │ ││ │ create_rollback: X │ ││ │ keep_running: │ ││ │ force: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'a' Down Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured - none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ┌──────────<Confirm Write backups/20261011T091558Z_0e0a6a17e6432a19>──────────┐ ││ │ │ ││ │ Run verify on backups/20261011T091558Z_0e0a6a17e6432a19 named pre-uninstall │ ││ │ │ ││ │ re-read the archive and check it against its manifest (shc backup verify) │ ││ │ │ ││ │ Provider will run: │ ││ │ shc backup verify 20261011T091558Z_0e0a6a17e6432a19 │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └─────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud 'a' Down Down Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ┌────────────────────────<mount>────────────────────────┐ ││ │ │ ││ │ mount the archive read-only on the daemon host (shc │ ││ │ backup mount); :mounts carries the path and the │ ││ │ umount │ ││ │ mountpoint: a path on the daemon host; the daemon │ ││ │ allocates one under its state dir otherwise │ ││ │ │ ││ │ mountpoint: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d5┌─────────────────────────<Confirm Write backups/20261011T091558Z_0e0a6a17e6432a19>──────────────────────────┐ restic home01 ││ │ │ ││ │ Run mount on backups/20261011T091558Z_0e0a6a17e6432a19 named pre-uninstall │ ││ │ │ ││ │ mount the archive read-only on the daemon host (shc backup mount); :mounts carries the path and the umount │ ││ │ │ ││ │ mountpoint: │ ││ │ │ ││ │ Provider will run: │ ││ │ shc backup mount --id 20261011T091558Z_0e0a6a17e6432a19 │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud 'v' 'm'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-s> Sort Status Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Umount Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <shift-a> Sort Age Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── mounts(all)[1] ───────────────────────────────────────────────────────────────────────┐│ ID↑ BACKUP PATH STATUS NODE TENANT ││ b5336f8b67b3d116 20261010T230024Z_17e787ecd76bc66f /var/lib/shc/backup-mounts/20261010T230 running home01 prod ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup> <mount>:mounts is what the mount left; c copies the path and umount, the
one entry of its menu, releases it.
$ tmux send-keys -t hud 'c' 'a' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-s> Sort Status Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Umount Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <shift-a> Sort Age Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── mounts(all)[1] ───────────────────────────────────────────────────────────────────────┐│ ID↑ BACKUP PATH STATUS NODE TENANT ││ b5336f8b67b3d116 20261010T230024Z_17e787ecd76bc66f /var/lib/shc/backup-mounts/20261010T230 running home01 prod ││ ││ ││ ││ ││ ││ ┌────────────<Confirm Write mounts/b5336f8b67b3d116>─────────────┐ ││ │ │ ││ │ Run umount on mounts/b5336f8b67b3d116 │ ││ │ │ ││ │ release this FUSE mount on the daemon host (shc backup umount) │ ││ │ │ ││ │ Provider will run: │ ││ │ shc backup umount b5336f8b67b3d116 │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup> <mount>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-s> Sort Status Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Umount Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <shift-a> Sort Age Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── mounts(all)[0] ───────────────────────────────────────────────────────────────────────┐│ ID↑ BACKUP PATH STATUS NODE TENANT ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup> <mount>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'w'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ┌───<export backup 20261011T091558Z_0e0a6a17e6432a19>───┐ ││ │ │ ││ │ A one-off archive for `shc backup restore --file` or │ ││ │ `shc backup import`. Nothing indexes or sweeps it, so │ ││ │ where it lives is yours to decide. │ ││ │ file: where it lands on this machine: a directory, or │ ││ │ a path ending in its name (--file) │ ││ │ │ ││ │ file: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing backups/new. Save to apply, quit unchanged to abort.# A new backup: "shc backup create" as a document. The archive is taken# asynchronously; saving this enqueues it and :tasks shows it running.## The deployment must live in the TENANT you are browsing (:tenants, "u"# to switch), which is why there is no tenant field here.
# stack: which deployment to back up. REQUIRED. The name from :stacks.stack: ""
# environment: which environment of that deployment. Defaults to "default"# and (tenant, stack, environment) is one deployment, so backing up the# wrong environment is the mistake this field prevents.# environment: prod
# name: a label for the archive. The daemon names it by timestamp# otherwise, which is fine for scheduled backups and unhelpful for the one# you take before an upgrade.# name: pre-upgrade
# paths: back up only these of the deployment's mounts or converters, by# name, instead of all of them (--paths, one comma-separated list, so a name# cannot itself contain a comma).# paths:# - uploads
# exclude: patterns to leave out (--exclude, comma-separated likewise).# Caches and search indexes are the usual ones: they rebuild, and they can# dwarf the real data.# exclude:# - /data/cache
# pause_timeout: seconds to spend ACQUIRING the pause before archiving# (--timeout). Unset uses the configured timeouts.quiesce, or this stack's# own backup.yaml override.# pause_timeout: 30
# all_connected / with_dependants: widen the archive to the deployments# wired to this one: everything it connects to, or everything that# depends on it. Either produces a CONSISTENCY GROUP that restores# together; set one, not both.# all_connected: false# with_dependants: false"/tmp/x9s-edit-3961025192.yaml" 43L, 1731B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b completed - full 33.0K - 2026-10-11T09:42:04Z assured - restic home01 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <m> Mount <shift-v> Verify Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New <v> Views Deployments: 9 (9 healthy) <d> Describe <shift-r> Restore <y> YAML Tenant: prod <w> Export <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.3┌────────────────────────────────────────────────────────────────────── backups(all)[6] ───────────────────────────────────────────────────────────────────────┐│ ID↑ STATUS CAUSE TYPE SIZE BYTES APPARENT BYTES TIMESTAMP POINT IN TIME VERIFIED ENCRYPTION NODE ││ 20261011T091558Z_0e0a6a17e6432a19 completed - full 420.2K - 2026-10-11T09:15:58Z assured local none home01 ││ 20261011T091819Z_487b4abfe3dea558 completed - full 2.5M 38.5M 2026-10-11T09:18:26Z assured manifest restic home01 ││ 20261011T091837Z_40a479b214138ba9 completed - full 28.3M - 2026-10-11T09:18:44Z assured - restic home01 ││ 20261011T093033Z_e6f97f19b78defac completed - full 11.3K 8.7K 2026-10-11T09:30:38Z assured - restic home01 ││ 20261011T093338Z_7f0ea84863f7819a completed - full 27.8K - 2026-10-11T09:33:41Z assured - restic home01 ││ 20261011T094159Z_1542d50c3965ba1b com┌──────────<Confirm Write backups/20261011T091558Z_0e0a6a17e6432a19>──────────┐ - restic home01 ││ │ │ ││ │ Run delete on backups/20261011T091558Z_0e0a6a17e6432a19 named pre-uninstall │ ││ │ │ ││ │ delete the archive (shc backup rm) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc backup rm 20261011T091558Z_0e0a6a17e6432a19 -y │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └─────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backup>$ tmux send-keys -t hud Escape:volumes is the provider volumes bound to deployments. No deployment of
this cluster has one bound, so the table is empty here. Its menu holds
rebind, snapshot, restore-snapshot, mount, mount-rw and
delete; m is the read-only mount on the daemon host and ctrl-d the
delete of volume and data. The writable mount has no key on purpose.
:volumemounts is what m leaves, empty here too; ctrl-d releases one.
:storage is
the providers: Enter lists a provider’s volumes, e opens the form that
sets its node set, l tails a managed provider’s journal, ctrl-n opens
a template for a new provider and ctrl-d removes one. :exports is the
archives exporters wrote; Shift-R imports one.
$ tmux send-keys -t hud ':volumes' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-m> Rebind Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-r> Restore-Snapshot Deployments: 9 (9 healthy) <d> Describe <b> Snapshot Tenant: prod <ctrl-j> Follow <shift-n> Sort Name Stack: all <?> Help <shift-s> Sort Status Environment: all <m> Mount <y> YAML shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── volumes(all)[0] ───────────────────────────────────────────────────────────────────────┐│ ID↑ TENANT STACK MOUNT PROVIDER ACCESS SIZE NODE STATE ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <volume>$ tmux send-keys -t hud ':volumemounts' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-d> Umount Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <shift-a> Sort Age Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── volumemounts(all)[0] ────────────────────────────────────────────────────────────────────┐│ ID↑ TENANT SOURCE TARGET MODE OWNER EXPIRES ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <volumemount>$ tmux send-keys -t hud ':storage' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Nodes Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-n> Sort Name Deployments: 9 (9 healthy) <d> Describe <v> Views Tenant: prod <?> Help <y> YAML Stack: all <l> Logs Environment: all <ctrl-n> New shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── storage(all)[2] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE FILESYSTEM MANAGED QUOTA SNAPSHOT NODES PATH ││ node:node-3bc8877f7db3 local - true false false - /var/lib/shc ││ node:node-d637b06c91fe local - true false false - /var/lib/shc ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage>$ tmux send-keys -t hud 'g' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-m> Rebind Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-r> Restore-Snapshot Deployments: 9 (9 healthy) <d> Describe <b> Snapshot Tenant: prod <ctrl-j> Follow <shift-n> Sort Name Stack: all <?> Help <shift-s> Sort Status Environment: all <m> Mount <y> YAML shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── volumes(all)[0] ───────────────────────────────────────────────────────────────────────┐│ ID↑ TENANT STACK MOUNT PROVIDER ACCESS SIZE NODE STATE ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage> <volume>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'e'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Nodes Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-n> Sort Name Deployments: 9 (9 healthy) <d> Describe <v> Views Tenant: prod <?> Help <y> YAML Stack: all <l> Logs Environment: all <ctrl-n> New shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── storage(all)[2] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE FILESYSTEM MANAGED QUOTA SNAPSHOT NODES PATH ││ node:node-3bc8877f7db3 local - true false false - /var/lib/shc ││ node:node-d637b06c91fe local - true false false - /var/lib/shc ││ ││ ││ ││ ││ ┌───────────<nodes of node:node-3bc8877f7db3>───────────┐ ││ │ │ ││ │ Tick the nodes node:node-3bc8877f7db3 is offered on. │ ││ │ node.node-3bc8877f7db3: offer node:node-3bc8877f7db3 │ ││ │ on home01 │ ││ │ node.node-d637b06c91fe: offer node:node-3bc8877f7db3 │ ││ │ on home02 │ ││ │ │ ││ │ node.node-3bc8877f7db3: │ ││ │ node.node-d637b06c91fe: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'l'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <n> Next Match Deployments: 9 (9 healthy) <shift-n> Prev Match Tenant: prod <r> Toggle Auto-Refresh Stack: all <f> Toggle FullScreen Environment: all shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────── Logs(node:node-3bc8877f7db3) ────────────────────────────────────────────────────────────────┐│ !! logs failed: bad_request: node:node-3bc8877f7db3 keeps no service journal on the daemon host: only the managed providers do (`shc storage logs nfs`, `shc ││ storage logs cephfs`) ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage> <logs>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing storage/new. Save to apply, quit unchanged to abort.# A new storage provider: "shc storage add" as a document. This adds a# LOCAL-type provider over an existing mount path; the managed nfs/cephfs# providers have their own CLI subtrees ("shc storage nfs enable",# "shc storage cephfs enable") and are not created from here.
# name: what to call the provider. REQUIRED: it is what link/unlink/rm# address, and the PROVIDER cell on :volumes. The names "local", "nfs"# and "cephfs" are reserved for shc-managed providers.name: ""
# path: the mount path the provider stores under (--path). REQUIRED. It# must exist on the node(s) you link.path: ""
# node: link the provider to this node right away (--node). Browse :nodes# for the ids; the "link" action on the new row adds more later.# node: node-52486a840f53
# connection: a named connection supplying the backend's credentials# (--connection), for providers backed by an external service.# connection: hz-s3~~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-1553028203.yaml" 22L, 988B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Nodes Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-n> Sort Name Deployments: 9 (9 healthy) <d> Describe <v> Views Tenant: prod <?> Help <y> YAML Stack: all <l> Logs Environment: all <ctrl-n> New shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── storage(all)[2] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE FILESYSTEM MANAGED QUOTA SNAPSHOT NODES PATH ││ node:node-3bc8877f7db3 local - true false false - /var/lib/shc ││ node:node-d637b06c91fe local - true false false - /var/lib/shc ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage>$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Nodes Cluster: 2 nodes <1> default <ctrl-d> Delete <shift-n> Sort Name Deployments: 9 (9 healthy) <d> Describe <v> Views Tenant: prod <?> Help <y> YAML Stack: all <l> Logs Environment: all <ctrl-n> New shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── storage(all)[2] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE FILESYSTEM MANAGED QUOTA SNAPSHOT NODES PATH ││ node:node-3bc8877f7db3 local - true false false - /var/lib/shc ││ node:node-d637b06c91fe local - true false false - /var/lib/shc ││ ││ ││ ││ ││ ││ ┌───────────────────────<delete>────────────────────────┐ ││ │ │ ││ │ remove the provider (shc storage rm) │ ││ │ force: remove it even while volumes still reference │ ││ │ it │ ││ │ │ ││ │ force: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <storage>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':exports' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <shift-r> Import Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── exports(all)[1] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ SIZE AGE ││ 004bd4c63bef830c.exp 1.1K 52m ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <export>$ tmux send-keys -t hud 'g' 'R'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <shift-r> Import Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── exports(all)[1] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ SIZE AGE ││ 004bd4c63bef830c.exp 1.1K 52m ││ ││ ││ ┌───────────────────────<import>────────────────────────┐ ││ │ │ ││ │ restore over the target deployment the NEWEST archive │ ││ │ the named exporter wrote for it, which may not be │ ││ │ this row: the route takes no archive name (shc │ ││ │ import) │ ││ │ exporter: the exporter whose import job restores the │ ││ │ archive │ ││ │ stack: the deployment to import into; this row's when │ ││ │ blank │ ││ │ environment: its environment; this row's when blank │ ││ │ │ ││ │ exporter: │ ││ │ stack: │ ││ │ environment: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <export>$ tmux send-keys -t hud EscapeBackup keys and retention
Section titled “Backup keys and retention”:backupkeys is the keys that open the backup repository: n rotates
to a new one the daemon generates, ctrl-d retires an old one and refuses
on the current. :retention is one row per tier of the resolved backup
retention: e sets a tier’s count, d previews what an apply would
delete, t applies now, ctrl-d resets the scope to the shipped
defaults. All three verbs are Danger, so read them and leave.
$ tmux send-keys -t hud ':backupkeys' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <?> Help <y> YAML Tenant: prod <ctrl-d> Rm Stack: all <n> Rotate Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── backupkeys(all)[1] ─────────────────────────────────────────────────────────────────────┐│ ID↑ CURRENT AGE HOST USER ││ ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 true 53m home01 root ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backupkey>$ tmux send-keys -t hud 'n'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <?> Help <y> YAML Tenant: prod <ctrl-d> Rm Stack: all <n> Rotate Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── backupkeys(all)[1] ─────────────────────────────────────────────────────────────────────┐│ ID↑ CURRENT AGE HOST USER ││ ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 true 53m home01 root ││ ││ ││ ││ ││┌────────────────────────────────<Confirm Write backupkeys/ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8>─────────────────────────────────┐│││ ││││ Run rotate on backupkeys/ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 ││││ ││││ re-key every repository the backup key opens, each location's off-site repo included, with a key the daemon generates; copies held elsewhere need the new ││││ ││││ This is not reversible. ││││ ││││ Provider will run: ││││ shc backup key rotate -y ││││ ││││ ││││ Cancel Confirm Write ││││ │││└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backupkey>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'g' C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <?> Help <y> YAML Tenant: prod <ctrl-d> Rm Stack: all <n> Rotate Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── backupkeys(all)[1] ─────────────────────────────────────────────────────────────────────┐│ ID↑ CURRENT AGE HOST USER ││ ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 true 53m home01 root ││ ││ ││ ││ ││┌────────────────────────────────<Confirm Write backupkeys/ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8>─────────────────────────────────┐│││ ││││ Run rm on backupkeys/ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 ││││ ││││ retire this key from the backup repository; the current key is refused (shc backup key rm) ││││ ││││ This is not reversible. ││││ ││││ Provider preview FAILED: ││││ bad_request: key ba920fdc02cb8c92afd63f2e1679dbdd3a2a75cbc8a9577f6df4d6384f62ffd8 is the current key, the one shc opens the repository with: rotate (n) ││││ ││││ ││││ Cancel Confirm Write ││││ │││└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <backupkey>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':retention' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Set Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────────────────── retention(all)[4] ──────────────────────────────────────────────────────────────────────┐│ TIER↑ KEEP SCOPE ││ daily 7 tenant prod ││ monthly 12 tenant prod ││ weekly 4 tenant prod ││ yearly 5 tenant prod ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <retention>$ tmux send-keys -t hud 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌─────────────────────────────────────────────────────────────────── Describe(prod//daily) ────────────────────────────────────────────────────────────────────┐│ preview: ││ bytes_to_free: 0 ││ keep_by_category: ││ daily: 2 ││ monthly: 0 ││ weekly: 0 ││ yearly: 4 ││ policy: ││ bundle_days: 30 ││ daily: 7 ││ monthly: 12 ││ weekly: 4 ││ yearly: 5 ││ to_delete_count: 0 ││ to_delete_details: <none> ││ to_keep_count: 6 ││ scope: tenant prod ││ tier: daily ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <retention> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'e'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Set Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────────────────── retention(all)[4] ──────────────────────────────────────────────────────────────────────┐│ TIER↑ KEEP SCOPE ││ daily 7 tenant prod ││ monthly 12 tenant prod ││ weekly 4 tenant prod ││ yearly 5 tenant prod ││ ││ ││ ││ ┌─────────────────────────<set>─────────────────────────┐ ││ │ │ ││ │ keep this many backups of this tier; the daemon │ ││ │ applies the change within five minutes, so a lower │ ││ │ count deletes the surplus (shc retention set) │ ││ │ keep: how many backups of this tier to keep │ ││ │ │ ││ │ keep: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <retention>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 't'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Set Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────────────────── retention(all)[4] ──────────────────────────────────────────────────────────────────────┐│ TIER↑ KEEP SCOPE ││ daily 7 tenant prod ││ monthly 12 tenant prod ││ weekly 4 tenant prod ││ yearly 5 tenant prod ││ ││ ┌───────────────────────────────<Confirm Write retention/prod//daily>───────────────────────────────┐ ││ │ │ ││ │ Run apply on retention/prod//daily │ ││ │ │ ││ │ delete every backup of this scope the policy no longer keeps; d previews it (shc retention apply) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc retention apply -y │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └───────────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <retention>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <e> Set Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────────────────── retention(all)[4] ──────────────────────────────────────────────────────────────────────┐│ TIER↑ KEEP SCOPE ││ daily 7 tenant prod ││ monthly 12 tenant prod ││ weekly 4 tenant prod ││ yearly 5 tenant prod ││ ││┌───────────────────────────────────────────────────────────<Confirm Write retention/prod//daily>────────────────────────────────────────────────────────────┐│││ ││││ Run reset on retention/prod//daily ││││ ││││ write the shipped defaults over ALL FOUR tiers of this scope, not only this row's; the daemon applies them within five minutes, deleting what they no long ││││ ││││ This is not reversible. ││││ ││││ Provider will run: ││││ shc retention reset ││││ ││││ ││││ Cancel Confirm Write ││││ │││└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <retention>$ tmux send-keys -t hud EscapeSecrets, the vault and config
Section titled “Secrets, the vault and config”:secrets is shc vault ls. Values never sit in the table: x fetches
the focused one and shows it in the VALUE cell, wide, until x again;
c copies it. This page reads the screen before x and after the second
x, never while a value shows, so no secret lands in a page. Its menu
holds set, which asks the new value in a masked field, and delete,
which is ctrl-d; ctrl-n makes a new key through a form. The backup repository password the cluster sealed at init is a row
here.
$ tmux send-keys -t hud ':secrets' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── secrets(all)[16] ──────────────────────────────────────────────────────────────────────┐│ KEY↑ SCOPE ││ apppass_key deployment ││ backup/password global ││ forward_auth_client_secret global ││ forward_auth_client_secret/realm/master global ││ forward_auth_client_secret/realm/prod global ││ forward_auth_secret global ││ keycloak_client_secret deployment ││ mysql_password deployment ││ password deployment ││ postgres_password deployment ││ var_admin.password deployment ││ var_password deployment ││ var_postgres.password deployment ││ var_root.password deployment ││ var_s3.secretKey deployment ││ webdav_deposit_password deployment ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud '/' 'backup' Enter C-w$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────── secrets(all)[1] </backup> ──────────────────────────────────────────────────────────────────┐│ KEY↑ VALUE SCOPE TENANT STACK ENV UPDATED CREATED DEPLOYMENT ││ backup/password •••••• global - - - 65m 65m ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud 'x'$ tmux send-keys -t hud 'x'$ tmux send-keys -t hud 'c' C-w$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────── secrets(all)[1] </backup> ──────────────────────────────────────────────────────────────────┐│ KEY↑ SCOPE ││ backup/password global ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────── secrets(all)[1] </backup> ──────────────────────────────────────────────────────────────────┐│ KEY↑ SCOPE ││ backup/password global ││ ││ ││ ┌─────────────────────<new secrets>─────────────────────┐ ││ │ │ ││ │ key: the secret's name, what deployments reference │ ││ │ value: the secret itself │ ││ │ scope: the tier (--scope); derived from │ ││ │ stack/environment when unset │ ││ │ stack: the deployment it belongs to (-s), for the │ ││ │ stack and deployment tiers │ ││ │ environment: which environment (-e), for the │ ││ │ environment and deployment tiers │ ││ │ │ ││ │ key: │ ││ │ value: │ ││ │ scope: │ ││ │ stack: │ ││ │ environment: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'a' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────── secrets(all)[1] </backup> ──────────────────────────────────────────────────────────────────┐│ KEY↑ SCOPE ││ backup/password global ││ ││ ││ ││ ││ ││ ││ ┌─────────────────────────<set>─────────────────────────┐ ││ │ │ ││ │ replace the value (shc vault set) │ ││ │ value: the new value, never echoed in the │ ││ │ confirmation or the history │ ││ │ │ ││ │ value: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New Cluster: 2 nodes <1> default <c> Copy <x> Reveal Deployments: 9 (9 healthy) <ctrl-d> Delete <e> Set Tenant: prod <d> Describe <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <y> YAML shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────── secrets(all)[1] </backup> ──────────────────────────────────────────────────────────────────┐│ KEY↑ SCOPE ││ backup/password global ││ ││ ││ ││ ││ ┌<Confirm Write secrets/global////backup/password>┐ ││ │ │ ││ │ Run delete on secrets/global////backup/password │ ││ │ │ ││ │ remove the secret (shc vault rm) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc vault rm backup/password --scope global │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └─────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <secret>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-u:vault is the vault itself as one row. Shift-U unlocks it with a masked
password, n rotates the master password, Shift-M moves the cold-start
capability to another node, w exports a bundle, Shift-R imports one.
The header’s Warning row says vault locked when it is.
$ tmux send-keys -t hud ':vault' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud 'U'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ││ ││ ││ ││ ││ ┌───────────────────────<unlock>────────────────────────┐ ││ │ │ ││ │ unlock the vault so the daemon can read secrets again │ ││ │ (shc vault unlock) │ ││ │ password: the vault master password │ ││ │ │ ││ │ password: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'n'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ┌───────────────────────<rotate>────────────────────────┐ ││ │ │ ││ │ re-encrypt every secret under a new master password │ ││ │ and rewrite this node's auto-unlock drop-in; lose the │ ││ │ new password and nobody can unlock the vault (shc │ ││ │ vault rotate) │ ││ │ old_password: the current master password │ ││ │ new_password: the new master password │ ││ │ confirm_new_password: the new master password again │ ││ │ adopt_drop_in: replace a drop-in that holds a │ ││ │ password which is not the current master (--adopt- │ ││ │ drop-in) │ ││ │ │ ││ │ old_password: │ ││ │ new_password: │ ││ │ confirm_new_password: │ ││ │ adopt_drop_in: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'M'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ││ ││ ││ ││ ┌───────────────────────<replant>───────────────────────┐ ││ │ │ ││ │ plant the vault auto-unlock drop-in on another node, │ ││ │ declare it the cold-start holder and remove it from │ ││ │ the current one (shc vault coldstart replant) │ ││ │ node: the node to hold it, by name or id (--node); │ ││ │ blank picks the lowest node name │ ││ │ │ ││ │ node: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'w'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ┌───────────────────────<export>────────────────────────┐ ││ │ │ ││ │ write the secrets, encrypted under an export password │ ││ │ to a new file on the machine running this HUD (shc │ ││ │ vault export) │ ││ │ file: the file to create; an existing file is refused │ ││ │ password: the password the bundle is encrypted under │ ││ │ confirm_password: the export password again │ ││ │ tenant: only this tenant's secrets (--tenant) │ ││ │ stack: only this stack's secrets (-s) │ ││ │ environment: only this environment's secrets (-e) │ ││ │ │ ││ │ file: │ ││ │ password: │ ││ │ confirm_password: │ ││ │ tenant: │ ││ │ stack: │ ││ │ environment: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'R'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <n> Rotate Cluster: 2 nodes <1> default <d> Describe <shift-s> Sort Status Deployments: 9 (9 healthy) <w> Export <shift-u> Unlock Tenant: prod <?> Help <y> YAML Stack: all <shift-r> Import Environment: all <shift-m> Replant shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── vault(all)[1] ────────────────────────────────────────────────────────────────────────┐│ INITIALIZED↑ LOCKED COLDSTART-NODE ││ true false - ││ ││ ││ ││ ┌───────────────────────<import>────────────────────────┐ ││ │ │ ││ │ load a bundle from `shc vault export` into the vault │ ││ │ at the scopes it names; existing secrets are kept │ ││ │ unless overwrite (shc vault import) │ ││ │ file: the bundle on the machine running this HUD │ ││ │ password: the password the bundle was exported with │ ││ │ overwrite: replace secrets that already exist (-- │ ││ │ overwrite) │ ││ │ │ ││ │ file: │ ││ │ password: │ ││ │ overwrite: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <vault>$ tmux send-keys -t hud Escape:config is the scoped configuration, path, value and scope, with the
origin wide. e opens the row as a document, c copies the value, and
the menu holds set, which asks a new value for the row at its scope, and
delete, which is ctrl-d and unsets the row at exactly its scope. Read
each on the backup repository row and leave it as it is.
$ tmux send-keys -t hud ':config' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help Cluster: 2 nodes <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.2┌────────────────────────────────────────────────────────────────────── config(all)[136] ──────────────────────────────────────────────────────────────────────┐│ PATH↑ VALUE SCOPE ││ acme.default - - ││ acme.email - - ││ acme.providers - - ││ acme.wildcards - - ││ auth.gate_cookie_domain host - ││ auth.platform_admins - - ││ backup.aws_access_key_id - - ││ backup.aws_secret_access_key - - ││ backup.azure_account_key - - ││ backup.azure_account_name - - ││ backup.b2_account_id - - ││ backup.b2_account_key - - ││ backup.google_application_credentials - - ││ backup.password ref+vault://backup/password global ││ backup.repo /var/backups/shc/repo global ││ backup.retention.daily - - ││ backup.retention.monthly - - ││ backup.retention.weekly - - ││ backup.retention.yearly - - ││ concurrency.queue_max_depth 1000 - ││ crons - - ││ deploy.cpu_quota - - ││ deploy.cpu_reservation_ratio - - ││ deploy.limit_ratio - - ││ deploy.memory_quota - - ││ deploy.memory_reservation_ratio - - ││ deploy.placement_scoring - - ││ deploy.reservation_ratio - - ││ dev false - ││ dns.lan_address - - ││ dns.owner_id shc-1de3a9f8 global ││ dns.provider - - │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <config>$ tmux send-keys -t hud '/' 'backup.repo' Enter 'c' 'e'$ tmux capture-pane -pt hud# x9s: editing config/global////backup.repo. Save to apply, quit unchanged to abort.environment: ""path: backup.reposcope: globalstack_name: ""tenant_name: prodvalue: /var/backups/shc/repo~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-522966803.yaml" 7L, 195B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help Cluster: 2 nodes <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.2┌─────────────────────────────────────────────────────────────── config(all)[1] </backup.repo> ────────────────────────────────────────────────────────────────┐│ PATH↑ VALUE SCOPE ││ backup.repo /var/backups/shc/repo global ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <config>$ tmux send-keys -t hud 'a' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help Cluster: 2 nodes <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.2┌─────────────────────────────────────────────────────────────── config(all)[1] </backup.repo> ────────────────────────────────────────────────────────────────┐│ PATH↑ VALUE SCOPE ││ backup.repo /var/backups/shc/repo global ││ ││ ││ ││ ││ ││ ││ ┌─────────────────────────<set>─────────────────────────┐ ││ │ │ ││ │ replace the value at this row's scope (shc config │ ││ │ set) │ ││ │ value: the new value: numbers, bools and JSON parse │ ││ │ typed, anything else is a string │ ││ │ │ ││ │ value: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <config>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <?> Help Cluster: 2 nodes <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.2┌─────────────────────────────────────────────────────────────── config(all)[1] </backup.repo> ────────────────────────────────────────────────────────────────┐│ PATH↑ VALUE SCOPE ││ backup.repo /var/backups/shc/repo global ││ ││ ││ ││ ││ ┌──────────────────────────────<Confirm Write config/global////backup.repo>──────────────────────────────┐ ││ │ │ ││ │ Run delete on config/global////backup.repo │ ││ │ │ ││ │ remove the entry at exactly this scope; a broader scope's value may then cascade in (shc config unset) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc config unset backup.repo --scope global │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <config>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-uQuotas, tenants, users, connections, grants and integrations
Section titled “Quotas, tenants, users, connections, grants and integrations”:quotas is one row per axis of the tenant’s quota: e sets that
axis’s limit for the tenant (shc quota set), ctrl-d removes it (shc quota unset), and scan-disk, the first entry and t, measures disk now
and fills the disk axis. :tenants was the first page’s
facet; ctrl-n opens a template for a new tenant, ctrl-d deletes one,
and v lists its deployments, users, quotas, secrets, config,
connections, retention and constraints. :users is the tenant’s Keycloak
users: e edits roles and password, ctrl-k ends the user’s sessions
(logout), ctrl-d deletes one and ctrl-n opens a template. :connections is the credentials to outside systems: ctrl-d
deletes one and Enter lists its grants; :grants has ctrl-n, a form,
and ctrl-d, the revoke. :integrations is the plug and socket wiring:
ctrl-n wires a plug through a form, ctrl-d unwires one. Open each and
press each key.
$ tmux send-keys -t hud ':quotas' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Unset Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <t> Scan-Disk Environment: all <e> Set shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── quotas(all)[7] ───────────────────────────────────────────────────────────────────────┐│ SCOPE↑ AXIS LIMIT USED AVAILABLE USED% BASIS ││ tenant prod apps - 6 - - counted ││ tenant prod cpu - 3750m - - reserved ││ tenant prod deployments - 6 - - counted │...│ tenant prod environments - 0 - - counted ││ tenant prod memory - 7.4G - - reserved ││ tenant prod vdeployments - 0 - - counted ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <quota>$ tmux send-keys -t hud 'g' 'a' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Unset Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <t> Scan-Disk Environment: all <e> Set shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── quotas(all)[7] ───────────────────────────────────────────────────────────────────────┐│ SCOPE↑ AXIS LIMIT USED AVAILABLE USED% BASIS ││ tenant prod apps - 6 - - counted ││ tenant prod cpu - 3750m - - reserved ││ tenant prod deployments - 6 - - counted │...│ tenant prod environments - 0 - - counted ││ tenant prod memory - 7.4G - - reserved ││ tenant prod vdeploymen┌──────────────────────────<Confirm Write quotas/prod/apps>──────────────────────────┐ counted ││ │ │ ││ │ Run scan-disk on quotas/prod/apps │ ││ │ │ ││ │ measure this tenant's disk usage now (shc quota scan), filling the disk axis's `?` │ ││ │ │ ││ │ Provider will run: │ ││ │ shc quota scan │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <quota>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <d> Describe <ctrl-d> Unset Deployments: 9 (9 healthy) <ctrl-j> Follow <y> YAML Tenant: prod <?> Help Stack: all <t> Scan-Disk Environment: all <e> Set shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── quotas(all)[7] ───────────────────────────────────────────────────────────────────────┐│ SCOPE↑ AXIS LIMIT USED AVAILABLE USED% BASIS ││ tenant prod apps - 6 - - counted ││ tenant prod cpu - 3750m - - reserved ││ tenant prod deployments - 6 - - counted ││ tenant prod disk - 1.0G - - measured ││ tenant prod environments - 0 - - counted ││ tenant prod memory - 7.4G - - reserved ││ tenant prod vdeployments - 0 - - counted ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <quota>$ 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: 2 nodes <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.2┌────────────────────────────────────────────────────────────────────── tenants(all)[2] ───────────────────────────────────────────────────────────────────────┐│ ACTIVE NAME↑ STACKS ││ false master 3 ││ false prod 6 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing tenants/new. Save to apply, quit unchanged to abort.# A new tenant: "shc tenant add" as a document.## A tenant is SHC's isolation boundary: different tenants never see each# other's deployments, secrets, users or events. Its name is its identity:# every path, vault scope and DNS name derives from it, and there is no# rename.
# name: what to call it. REQUIRED. Letters, digits, and _ . - only.name: ""
# with_admin: create an administrator account in the new tenant's realm at# the same time. Without one, nobody can log in to it yet. On by default,# as on the CLI; false is --no-admin.# with_admin: true
# admin_username: that account's name (--admin-user).# admin_username: admin
# admin_password: its password. Leave it out and shc generates one and# stores it in the vault, which is usually what you want, since anything# typed here is a password you have now written down.# admin_password: ""~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-374367926.yaml" 23L, 932B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <u> Use Cluster: 2 nodes <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.2┌────────────────────────────────────────────────────────────────────── tenants(all)[2] ───────────────────────────────────────────────────────────────────────┐│ ACTIVE NAME↑ STACKS ││ false master 3 ││ false prod 6 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant>$ tmux send-keys -t hud '/' 'prod' Enter C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <u> Use Cluster: 2 nodes <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.2┌────────────────────────────────────────────────────────────────── tenants(all)[1] </prod> ───────────────────────────────────────────────────────────────────┐│ ACTIVE NAME↑ STACKS ││ false prod 6 ││ ││ ││ ││ ││ ││ ││ ┌───────────────────────<delete>────────────────────────┐ ││ │ │ ││ │ remove the tenant (shc tenant rm) │ ││ │ force: delete even while deployments remain (`shc │ ││ │ tenant rm --force`) │ ││ │ │ ││ │ force: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'u'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-k> Logout Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <shift-s> Sort Status Stack: all <ctrl-j> Follow <y> YAML Environment: all <?> Help shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── users(all)[0] ────────────────────────────────────────────────────────────────────────┐│ USERNAME↑ EMAIL ENABLED ROLES DIRECT ROLES ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <tenant> <user>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'v' 'q' Escape$ tmux send-keys -t hud 'v' 'k' Escape$ tmux send-keys -t hud 'v' 'g' Escape$ tmux send-keys -t hud 'v' 'c' Escape$ tmux send-keys -t hud 'v' 'r' Escape$ tmux send-keys -t hud 'v' 'p' Escape$ tmux send-keys -t hud 'v' 'd'$ 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: 2 nodes <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.2┌──────────────────────────────────────────────────────────────────── 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 Escape$ tmux send-keys -t hud C-u ':users' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-k> Logout Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <shift-s> Sort Status Stack: all <ctrl-j> Follow <y> YAML Environment: all <?> Help shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── users(all)[0] ────────────────────────────────────────────────────────────────────────┐│ USERNAME↑ EMAIL ENABLED ROLES DIRECT ROLES ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <user>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing users/new. Save to apply, quit unchanged to abort.# A new user: "shc user create" as a document.## The account is created in the TENANT you are browsing (:tenants, "u" to# switch), which is why there is no tenant field here: a user belongs to# exactly one tenant's realm.
# username: what they log in as. REQUIRED.username: ""
# name: the person's full name, given names then family name. REQUIRED.name: ""
# email: REQUIRED. Keycloak refuses password sign-in without an email.email: ""
# password: their initial password. Leave it out and shc generates one and# prints it once. Whatever is set here is never echoed back, not in the# confirmation, not in the mutation history.# password: ""## Roles are NOT set here: the account exists first, then "grant" on its# row gives it a role. That is shc's own shape: "shc user grant" is a# separate verb, not a field on the account.~~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-1578812498.yaml" 22L, 912B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-k> Logout Cluster: 2 nodes <1> default <ctrl-d> Delete <ctrl-n> New Deployments: 9 (9 healthy) <d> Describe <shift-n> Sort Name Tenant: prod <e> Edit <shift-s> Sort Status Stack: all <ctrl-j> Follow <y> YAML Environment: all <?> Help shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── users(all)[0] ────────────────────────────────────────────────────────────────────────┐│ USERNAME↑ EMAIL ENABLED ROLES DIRECT ROLES ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <user>$ tmux send-keys -t hud ':connections' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <ctrl-d> Delete <y> YAML Deployments: 9 (9 healthy) <d> Describe Tenant: prod <ctrl-j> Follow Stack: all <?> Help Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── connections(all)[0] ─────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE TENANT SCOPE DNS PURPOSE LOCATION ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <connection>$ tmux send-keys -t hud ':integrations' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-d> Unwire Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <shift-s> Sort Status shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── integrations(all)[3] ────────────────────────────────────────────────────────────────────┐│ CONSUMER↑ PLUG PROVIDER SOCKET STATUS ID ││ cloud postgres db postgres connected 0 ││ cloud s3 store s3 connected 0 ││ pgweb postgres db postgres connected 0 ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <integration>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-d> Unwire Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <shift-s> Sort Status shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── integrations(all)[3] ────────────────────────────────────────────────────────────────────┐│ CONSUMER↑ PLUG PROVIDER SOCKET STATUS ID ││ cloud postgres db postgres connected 0 ││ cloud s3 store s3 connected 0 ││ pgweb postgres db postgres connected 0 ││ ││ ┌─────────────────────<wire a plug>─────────────────────┐ ││ │ │ ││ │ Connects one plug of the consumer to a provider's │ ││ │ socket: shc update <consumer> -i │ ││ │ <plug>=<provider>[@env]. │ ││ │ consumer: the deployment whose plug is wired │ ││ │ plug: the consumer's plug, e.g. db │ ││ │ provider: the providing deployment's stack, stack@env │ ││ │ when it runs in another environment, or @connection │ ││ │ │ ││ │ consumer: prod/prod/cloud │ ││ │ plug: │ ││ │ provider: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <integration>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud 'g' C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-d> Unwire Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <shift-s> Sort Status shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── integrations(all)[3] ────────────────────────────────────────────────────────────────────┐│ CONSUMER↑ PLUG PROVIDER SOCKET STATUS ID ││ cloud postgres db postgres connected 0 ││ cloud s3 store s3 connected 0 ││ pgweb postgres db postgres connected 0 ││ ││ ││ ┌──────────────<Confirm Write integrations/prod/prod/db/postgres->cloud/postgres>───────────────┐ ││ │ │ ││ │ Run unwire on integrations/prod/prod/db/postgres->cloud/postgres │ ││ │ │ ││ │ disconnect the consumer's plug and run the edge's teardown (shc update <consumer> -i <plug>!) │ ││ │ │ ││ │ This is not reversible. │ ││ │ │ ││ │ Provider will run: │ ││ │ shc -e prod update cloud -i 'postgres!' │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └───────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <integration>$ tmux send-keys -t hud EscapeIngress and DNS
Section titled “Ingress and DNS”:ingress is every router the daemon wrote for Traefik: c copies the
host, d shows the route document. :dns is every record SHC published
through its DNS connections, read-only; Enter opens the record’s owner and
c copies the name. This cluster has no public host and no DNS
connection: :ingress holds the ACME challenge router alone and :dns
is empty.
$ tmux send-keys -t hud ':ingress' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <c> Copy Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <shift-n> Sort Name Stack: all <y> YAML Environment: all shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── ingress(all)[1] ───────────────────────────────────────────────────────────────────────┐│ FILE↑ ROUTER HOST UPSTREAM MIDDLEWARES TARGET ││ acme-challenge.yaml acme-http-01 - http://shc:8000 - - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <ingres>$ tmux send-keys -t hud 'g' 'c' 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────── Describe(acme-challenge.yaml#acme-http-01) ─────────────────────────────────────────────────────────┐│ content: ││ http: ││ routers: ││ acme-http-01: ││ rule: PathPrefix(`/.well-known/acme-challenge/`) ││ entryPoints: ││ - web ││ priority: 2147483647 ││ service: acme-http-01 ││ services: ││ acme-http-01: ││ loadBalancer: ││ servers: ││ - url: http://shc:8000 ││ ││ dynamic_dir: /var/lib/shc/clusterfs/traefik/current/dynamic ││ file: acme-challenge.yaml ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <ingres> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':dns' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <c> Copy Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <shift-n> Sort Name Stack: all <v> Views Environment: all <y> YAML shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────────── dns(all)[0] ─────────────────────────────────────────────────────────────────────────┐│ NAME↑ TYPE VALUE ZONE CONNECTION TENANT DEPLOYMENT ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <dn>Schedules, jobs, runs and crons
Section titled “Schedules, jobs, runs and crons”:schedules is what fires on each deployment, cron schedules and backup
schedules in one table: t fires one now, e changes its cron,
Shift-E pauses an armed one or arms a paused one, ctrl-d deletes one
and ctrl-n opens a template for a new one. :jobs is the jobs each deployment declares: t
runs one, Enter lists its runs. :runs is the runs, running and finished:
d is the run’s status, ctrl-k cancels a pending one. :crons is the
daemon’s own maintenance crons, read-only, each with when it last fired
and how that ended. The job run here is
cloud’s disable-maintenance-mode, which turns Nextcloud’s maintenance
mode off and says so when it is already off. A socket job such as
check-nextcloud-ready runs for its socket, and the daemon refuses to run
it by hand.
$ tmux send-keys -t hud ':schedules' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New <y> YAML Cluster: 2 nodes <1> default <ctrl-d> Delete <t> Run Deployments: 9 (9 healthy) <d> Describe <e> Set Tenant: prod <shift-e> Enable <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── schedules(all)[0] ──────────────────────────────────────────────────────────────────────┐│ JOB↑ CRON ENABLED LAST RUN AT NEXT RUN AT STACK ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <schedule>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing schedules/new. Save to apply, quit unchanged to abort.# A new schedule: "shc schedule add" as a document. The cron expression# is validated and next_run_at computed at insert time; a job with no# <job>.job.yaml in the stack's app yet is stored with a warning (the app# may ship the job later).## The schedule lands in the TENANT you are browsing (:tenants, "u" to# switch), which is why there is no tenant field here.
# job: the job to run, the name of a <job>.job.yaml the stack's app# declares. REQUIRED.job: ""
# cron: when to run it, standard five-field cron. REQUIRED.# Examples: "0 3 * * *" (daily 03:00), "*/15 * * * *" (every 15 min).cron: ""
# stack: which deployment the job runs against (--stack / -s). REQUIRED.stack: ""
# environment: which environment of that deployment (-e). Defaults to the# estate default.# environment: prod~~~~~~~~~~~~~~~~~~~~"/tmp/x9s-edit-703372035.yaml" 23L, 876B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New <y> YAML Cluster: 2 nodes <1> default <ctrl-d> Delete <t> Run Deployments: 9 (9 healthy) <d> Describe <e> Set Tenant: prod <shift-e> Enable <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── schedules(all)[0] ──────────────────────────────────────────────────────────────────────┐│ JOB↑ CRON ENABLED LAST RUN AT NEXT RUN AT STACK ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <schedule>$ tmux send-keys -t hud ':jobs' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <t> Run Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── jobs(all)[57] ────────────────────────────────────────────────────────────────────────┐│ JOB↑ CONTEXT SOURCE PHASE TIMEOUT ││ check-nextcloud-ready http socket discovery 600s ││ check-postgres-ready container socket discovery 720s ││ check-webdav-ready http socket discovery 600s ││ clear-onlyoffice service plug unintegration 600s ││ clear-paperless-url service plug unintegration 600s ││ clear-read-only service standalone - 600s ││ clear-stirling-external-site service plug unintegration 600s ││ configure-docuseal service plug post_deployment 600s ││ configure-llm service plug post_deployment 600s ││ configure-oidc service plug post_deployment 300s ││ configure-onlyoffice service plug post_deployment 600s ││ configure-paperless-integration service plug post_deployment 600s ││ configure-stirling-external-site service plug post_deployment 600s ││ create-database container socket integration 720s ││ deprovision-mail-provisioning service plug unintegration 300s ││ disable-files-stirling service plug unintegration 600s ││ disable-maintenance-mode service standalone - 60s ││ dump container exporter export 600s ││ enable-maintenance-mode service standalone - 60s ││ grant-nextcloud-admin service socket integration 600s ││ handover service standalone - 600s ││ install-files-stirling service plug post_deployment 600s ││ install-plugin service vsocket integration 600s ││ load container exporter import 600s ││ nextcloud-export service exporter export 3600s ││ nextcloud-import service exporter import 3600s ││ nextcloud-init service standalone - 600s ││ nextcloud-subscribe-calendar-feeds service socket integration 600s ││ nextcloud-sweep-calendar-feeds service socket unintegration 900s ││ pg-dump container exporter export 3600s ││ pg-restore container exporter import 3600s ││ pg-upgrade container standalone - 600s │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job>$ tmux send-keys -t hud '/' 'disable-maintenance-mode' Enter$ tmux send-keys -t hud 't'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <t> Run Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────── jobs(all)[1] </disable-maintenance-mode> ──────────────────────────────────────────────────────────┐│ JOB↑ CONTEXT SOURCE PHASE TIMEOUT ││ disable-maintenance-mode service standalone - 60s ││ ││ ││ ││ ││ ││ ││ ┌─────────────────────────<run>─────────────────────────┐ ││ │ │ ││ │ run this job now (shc job run) │ ││ │ vars: variable overrides as KEY=VALUE, comma- │ ││ │ separated; each is one --var │ ││ │ │ ││ │ vars: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <t> Run Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────── jobs(all)[1] </disable-maintenance-mode> ──────────────────────────────────────────────────────────┐│ JOB↑ CONTEXT SOURCE PHASE TIMEOUT ││ disable-maintenance-mode service standalone - 60s ││ ││ ││ ││ ││ ┌Confirm Write jobs/prod/prod/cloud/disable-maintenance-mo…┐ ││ │ │ ││ │ Run run on jobs/prod/prod/cloud/disable-maintenance-mode │ ││ │ │ ││ │ run this job now (shc job run) │ ││ │ │ ││ │ vars: │ ││ │ │ ││ │ Provider will run: │ ││ │ shc -e prod job run disable-maintenance-mode -s cloud │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └──────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <v> Views Cluster: 2 nodes <1> default <d> Describe <y> YAML Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <t> Run Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────── jobs(all)[1] </disable-maintenance-mode> ──────────────────────────────────────────────────────────┐│ JOB↑ CONTEXT SOURCE PHASE TIMEOUT ││ disable-maintenance-mode service standalone - 60s ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job>$ tmux send-keys -t hud Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-k> Cancel <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <ctrl-j> Follow Stack: all <?> Help Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────────── runs(all)[1] ────────────────────────────────────────────────────────────────────────┐│ ID↑ JOB STACK STATUS ELAPSED STARTED ││ 1 disable-maintenance-mode cloud completed 1.0s 20s ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job> <run>$ tmux send-keys -t hud 'g' 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌────────────────────────────────────────────────────────────────────── Describe(prod/1) ──────────────────────────────────────────────────────────────────────┐│ completed_at: 2026-10-11T05:30:07.751674329Z ││ created_at: 2026-10-11T05:30:04.480787129Z ││ elapsed_seconds: 1.03763162 ││ environment: prod ││ exit_code: 0 ││ id: 1 ││ job_name: disable-maintenance-mode ││ stack_name: cloud ││ started_at: 2026-10-11T05:30:05.442254428Z ││ status: completed ││ stdout: ││ Maintenance mode already disabled ││ ││ task_id: 4bf84c48-71fa-4c5a-be9c-93086504b7b4 ││ tenant_name: prod ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job> <run> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-k$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-k> Cancel <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <ctrl-j> Follow Stack: all <?> Help Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────────── runs(all)[1] ────────────────────────────────────────────────────────────────────────┐│ ID↑ JOB STACK STATUS ELAPSED STARTED ││ 1 disable-maintenance-mode cloud completed 1.0s 43s ││ ││ ││ ││ ││ ││ ││ ┌───────────────────────<cancel>────────────────────────┐ ││ │ │ ││ │ cancel a pending run (shc job cancel); the daemon │ ││ │ refuses one already running │ ││ │ reason: recorded on the cancelled task; the daemon │ ││ │ writes "cancelled by operator" when blank │ ││ │ │ ││ │ reason: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job> <run>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-u 'v' 'h'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <ctrl-n> New <y> YAML Cluster: 2 nodes <1> default <ctrl-d> Delete <t> Run Deployments: 9 (9 healthy) <d> Describe <e> Set Tenant: prod <shift-e> Enable <shift-a> Sort Age Stack: all <ctrl-j> Follow <shift-n> Sort Name Environment: all <?> Help <shift-s> Sort Status shc9s Rev: 0.1.2┌───────────────────────────────────────────────────────────────────── schedules(all)[0] ──────────────────────────────────────────────────────────────────────┐│ JOB↑ CRON ENABLED LAST RUN AT NEXT RUN AT STACK ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <job> <schedule>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':runs' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-k> Cancel <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <ctrl-j> Follow Stack: all <?> Help Environment: all <shift-a> Sort Age shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────────── runs(all)[1] ────────────────────────────────────────────────────────────────────────┐│ ID↑ JOB STACK STATUS ELAPSED STARTED ││ 1 disable-maintenance-mode cloud completed 1.0s 67s ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <run>$ tmux send-keys -t hud ':crons' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <ctrl-d> Delete Cluster: 2 nodes <d> Describe Deployments: 9 (9 healthy) <e> Edit Tenant: prod <?> Help Stack: all <shift-j> Jump Owner Environment: all <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── crons(all)[30] ───────────────────────────────────────────────────────────────────────┐│ NAME↑ MODULE SCHEDULE CLASS TIMEOUT LEADER NEXT-RUN LAST-RUN LAST-STATUS │...└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <cron>Audit, certificates, licence, notifications and diagnoses
Section titled “Audit, certificates, licence, notifications and diagnoses”:audit is the hash-chained audit trail, the --audit listing of the
events page, read-only. :certificates is what the cluster’s CA issued,
read-only; shc cert rotate is the CLI’s. :license is the licence and
the portal registration: ctrl-n opens the form that installs a licence,
t refreshes it, ctrl-d delinks it. :notifications is the
notification rules; t sends a test through one. :diagnoses is shc doctor ls; t runs the focused row’s category, with or without --fix,
and d shows what the run found.
$ tmux send-keys -t hud ':audit' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <d> Describe Cluster: 2 nodes <1> default <ctrl-j> Follow Deployments: 9 (9 healthy) <?> Help Tenant: prod <shift-a> Sort Age Stack: all <y> YAML Environment: all shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────── audit(all)[100 of 240] ───────────────────────────────────────────────────────────────────┐│ TIME↑ CODE ACTOR TENANT STACK MESSAGE │...└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <audit>$ tmux send-keys -t hud 'g' 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌─────────────────────────────────────────────────────── Describe(d45375bd-9d6f-4d2a-b4b9-67ab0ba29485) ───────────────────────────────────────────────────────┐...└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <audit> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':certificates' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <ctrl-d> Delete Cluster: 2 nodes <d> Describe Deployments: 9 (9 healthy) <e> Edit Tenant: prod <?> Help Stack: all <shift-j> Jump Owner Environment: all <y> YAML shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────────────────── certificates(all)[2] ────────────────────────────────────────────────────────────────────┐│ NAME↑ KIND FINGERPRINT EXPIRES ││ cluster root 3664eb59c3f39f64710ede36635848924e714e022b39b9c2e4a694826f3c1400 - ││ global-root root df7116bc00dabd4daac83df7ba7af415315d9305a384b5bb62c9a032838e7fa2 - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <certificate>$ tmux send-keys -t hud 'g' 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────────────────── Describe(cluster) ──────────────────────────────────────────────────────────────────────┐│ fields: ││ EXPIRES: - ││ FINGERPRINT: 3664eb59c3f39f64710ede36635848924e714e022b39b9c2e4a694826f3c1400 ││ ISSUER: - ││ KIND: root ││ NAME: cluster ││ NOT-AFTER: - ││ PROVENANCE: autogen ││ id: cluster ││ source: list row (this type has no per-item detail route on this daemon) ││ type: certificates ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <certificate> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':license' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-d> Delink <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <t> Refresh shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── license(all)[2] ───────────────────────────────────────────────────────────────────────┐│ KIND↑ STATE TYPE HOLDER EXPIRES ││ license keyed pro Learn walk - ││ portal unregistered - - - ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <license>$ tmux send-keys -t hud 'g' 't'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-d> Delink <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <t> Refresh shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── license(all)[2] ───────────────────────────────────────────────────────────────────────┐│ KIND↑ STATE TYPE HOLDER EXPIRES ││ license keyed pro Learn walk - ││ portal unregistered - - - ││ ││ ││ ││ ││ ┌────────────────────────────────────<Confirm Write license/license>─────────────────────────────────────┐ ││ │ │ ││ │ Run refresh on license/license │ ││ │ │ ││ │ ask the licence broker now whether a newer licence applies, and install it if so (shc license refresh) │ ││ │ │ ││ │ Provider will run: │ ││ │ shc license refresh │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <license>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-d> Delink <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <t> Refresh shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── license(all)[2] ───────────────────────────────────────────────────────────────────────┐│ KIND↑ STATE TYPE HOLDER EXPIRES ││ license keyed pro Learn walk - ││ portal unregistered - - - ││ ││ ││ ││ ││ ┌─────────────────────<new license>─────────────────────┐ ││ │ │ ││ │ token: the vendor-signed licence token (shclic.v1.…); │ ││ │ or leave blank and name a file │ ││ │ file: a file on the machine running this HUD that │ ││ │ holds the token │ ││ │ │ ││ │ token: │ ││ │ file: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <license>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <shift-n> Sort Name Cluster: 2 nodes <1> default <ctrl-d> Delink <shift-s> Sort Status Deployments: 9 (9 healthy) <d> Describe <y> YAML Tenant: prod <?> Help Stack: all <ctrl-n> New Environment: all <t> Refresh shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── license(all)[2] ───────────────────────────────────────────────────────────────────────┐│ KIND↑ STATE TYPE HOLDER EXPIRES ││ license keyed pro Learn walk - ││ portal unregistered - - - ││ ││ ││ ││┌──────────────────────────────────────────────────────────────<Confirm Write license/license>───────────────────────────────────────────────────────────────┐│││ ││││ Run delink on license/license ││││ ││││ drop this estate's stored licence; it runs as trial or degraded until one is installed again, and a DNS-carried licence comes straight back (shc license d ││││ ││││ This is not reversible. ││││ ││││ Provider will run: ││││ shc license delink ││││ ││││ ││││ Cancel Confirm Write ││││ │││└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <license>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud ':notifications' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <shift-n> Sort Name Stack: all <t> Test Environment: all <y> YAML shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────── notifications(all)[3] ────────────────────────────────────────────────────────────────────┐│ NAME↑ CHANNEL ON DESTINATION PROVIDER ││ backup-failed none X500473BKPNOA,X500474BKPSRQ,X500467BKPHKF nowhere to send: notification.providers.operator is not defined operator ││ backup-fire-dropped none X500204BKSCSK,X500205BKSCTO nowhere to send: notification.providers.operator is not defined operator ││ backup-unprotected none X500470BKPCOV,X500478BKPPRO,X200091BKPCOW nowhere to send: notification.providers.operator is not defined operator ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <notification>$ tmux send-keys -t hud ':diagnoses' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <t> Run Stack: all <shift-n> Sort Name Environment: all <y> YAML shc9s Rev: 0.1.3┌───────────────────────────────────────────────────────────────────── diagnoses(all)[97] ─────────────────────────────────────────────────────────────────────┐│ NAME↑ CATEGORY FIX DESCRIPTION ││ app.appyaml-drift appdrift - report deployments whose app.yaml differs from the app package installed on the… ││ app.consumerless-deployments app - report deployments nothing binds to, such as a database left behind by an unins… ││ app.deployment-naming app - report deployments whose names drift from the naming convention ││ app.dns-estate-agreement app - check that the node rows, the placement rung and the DNS posture agree across t… ││ app.edge-certificates app - check that every routed host is served with a valid certificate at the edge ││ app.ingress-coverage app - check that every host a deployment publishes is routed by the ingress ││ app.ingress-publish-posture app - check that the ingress publish binds an explicit host address rather than every… ││ app.integration-drift app - report integration edges whose consumer or provider no longer binds as recorded ││ app.older-renders app - name each older render this node holds beside the deployment's committed render ││ app.package-drift app - report deployments whose rendered package differs from the catalogue's current … ││ app.pinned-package-fetchable app - check that every deployment's pinned package revision can still be fetched from… ││ app.telemetry-export app - report a managed telemetry export held back by an unreadable system vault ││ app.unbound-plugs app - report plugs a deployment declares that no socket is bound to ││ backup.armed backup - report credentials, mirrors and schedules armed over an estate that captured no… ││ backup.clone_staging backup - report clone staging roots a ledger location still points into ││ backup.coverage backup - report deployments that no backup schedule covers ││ backup.destination backup - check that every schedule's destination credentials resolve ││ backup.encryption backup - check that a backup encryption key is configured ││ backup.freshness backup - report schedules whose newest archive is older than their interval ││ backup.mirror_keys backup - check that every mirror destination's keys resolve ││ backup.orphans backup - report archives the ledger does not name and ledger rows with no bytes ││ backup.repositories backup - check that every repository the estate writes to or the ledger names still exis… ││ backup.schedule_coverage backup - report schedules that write nowhere but an unencrypted local copy ││ backup.schedule_fire backup - report schedules whose last fire failed or was skipped ││ backup.scope backup - check that every capture dumps only the database it owns ││ backup.scratch_volume backup - check that this node's capture peak lands on the volume the staging knobs name ││ backup.staging_space backup - check that this node's staging root has room to write a capture ││ backup.verify_sweep backup - check that the weekly deep-verify sweep ran on the leader, and what it found ││ collector.export-route collector - report a node whose container logs reach no store because its collector has no … ││ cron.fires cron - check that every cron on this node fires on time, no fire runs past its timeout… ││ database.orphaned-dirs database - check for deployment directories with no db record ││ database.orphaned-stacks database destructive check for db records with missing deployment directories ││ database.orphaned-vdeployments database destructive check for vdeployment registry rows with missing sidecars │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <diagnose>$ tmux send-keys -t hud '/' 'database.orphaned-dirs' Enter 't'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <t> Run Stack: all <shift-n> Sort Name Environment: all <y> YAML shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────── diagnoses(all)[1] </database.orphaned-dirs> ─────────────────────────────────────────────────────────┐│ NAME↑ CATEGORY FIX DESCRIPTION ││ database.orphaned-dirs database - check for deployment directories with no db record ││ ││ ││ ││ ││ ││ ││ ┌─────────────────────────<run>─────────────────────────┐ ││ │ │ ││ │ run every diagnosis in this row's category; d shows │ ││ │ what it found (shc doctor run) │ ││ │ fix: also apply the benign and mutating prescriptions │ ││ │ (--fix); never a destructive one │ ││ │ │ ││ │ fix: │ ││ │ │ ││ │ OK Cancel │ ││ │ │ ││ └───────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <diagnose>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <t> Run Stack: all <shift-n> Sort Name Environment: all <y> YAML shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────── diagnoses(all)[1] </database.orphaned-dirs> ─────────────────────────────────────────────────────────┐│ NAME↑ CATEGORY FIX DESCRIPTION ││ database.orphaned-dirs database - check for deployment directories with no db record ││ ││ ││ ││ ││ ┌─────────────<Confirm Write diagnoses/database/database.orphaned-dirs>──────────────┐ ││ │ │ ││ │ Run run on diagnoses/database/database.orphaned-dirs │ ││ │ │ ││ │ run every diagnosis in this row's category; d shows what it found (shc doctor run) │ ││ │ │ ││ │ fix: false │ ││ │ │ ││ │ Provider will run: │ ││ │ shc doctor run -c database │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └────────────────────────────────────────────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <diagnose>$ tmux send-keys -t hud Tab Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <?> Help Tenant: prod <t> Run Stack: all <shift-n> Sort Name Environment: all <y> YAML shc9s Rev: 0.1.2┌──────────────────────────────────────────────────────── diagnoses(all)[1] </database.orphaned-dirs> ─────────────────────────────────────────────────────────┐│ NAME↑ CATEGORY FIX DESCRIPTION ││ database.orphaned-dirs database - check for deployment directories with no db record ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <diagnose>$ tmux send-keys -t hud 'd'$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <c> Copy Cluster: 2 nodes <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.2┌───────────────────────────────────────────────────────── Describe(database/database.orphaned-dirs) ──────────────────────────────────────────────────────────┐│ diagnosis: ││ category: database ││ description: check for deployment directories with no db record ││ name: database.orphaned-dirs ││ last_run: ││ category: database ││ description: check for deployment directories with no db record ││ name: database.orphaned-dirs ││ verdict: pass ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <diagnose> <describe>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-uThe host’s own tables
Section titled “The host’s own tables”:types is the home: every table as a row, Enter opens it. :contexts
is the daemons this HUD knows; Enter or u switches, ctrl-n opens a
template for a new one in the editor, ctrl-d removes one. :forwards
and :mutations were the live page’s.
$ tmux send-keys -t hud ':types' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <ctrl-d> Delete Cluster: 2 nodes <d> Describe Deployments: 9 (9 healthy) <e> Edit Tenant: prod <?> Help Stack: all <y> YAML Environment: all shc9s Rev: 0.1.2┌─────────────────────────────────────────────────────────────────────── types(all)[39] ───────────────────────────────────────────────────────────────────────┐│ TYPE↑ ALIASES CAPABILITIES ││ addons list,get,watch,explain ││ apps list,get,watch,explain ││ audit list,get,watch ││ backupkeys list,get,watch,explain ││ backups list,get,watch,create,explain ││ certificates list,get,watch ││ cluster list,get,watch,explain ││ config list,get,watch,update,explain ││ connections list,get,watch,explain ││ constraints list,get,watch,create,explain ││ crons list,get,watch ││ deployments list,get,watch,logs,exec,forward,update,create,explain ││ diagnoses list,get,watch,explain ││ dns list,get,watch ││ events list,get,watch,logs ││ exports list,get,watch,explain ││ ingress list,get,watch ││ integrations list,get,watch,create,explain ││ jobs list,get,watch,explain ││ labels list,get,watch,explain ││ license list,get,watch,create,explain ││ mounts list,get,watch,explain ││ nodes list,get,watch,logs,explain ││ notifications list,get,watch,explain ││ pressure list,get,watch ││ quotas list,get,watch,explain ││ repos list,get,watch,update,create,explain ││ retention list,get,watch,explain ││ runs list,get,watch,explain ││ schedules list,get,watch,create,explain ││ secrets list,get,watch,reveal,create,explain ││ storage list,get,watch,logs,create,explain │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <type>$ tmux send-keys -t hud 'g' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <0> all <a> Actions <y> YAML Cluster: 2 nodes <1> default <d> Describe Deployments: 9 (9 healthy) <ctrl-j> Follow Tenant: prod <?> Help Stack: all <i> Install Environment: all <shift-n> Sort Name shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── addons(all)[143] ──────────────────────────────────────────────────────────────────────┐│ ADDON↑ VERSION VERSIONS DESCRIPTION ││ advanced-custom-fields latest 1 structured custom fields for posts and pages ││ akismet latest 1 spam comment filtering ││ all-in-one-seo-pack latest 1 SEO metadata, schema and sitemaps ││ all-in-one-wp-migration latest 1 single-file site export and import ││ all-in-one-wp-security-and-firewall latest 1 hardening, firewall and login lockdown ││ antispam-bee latest 1 comment spam filtering with no external service ││ appointments latest 1 book appointments into your calendar through a secure onlin… ││ approval latest 1 let users approve or reject files ││ autoptimize latest 1 aggregates and minifies CSS, JS and HTML ││ better-search-replace latest 1 serialization-safe database search and replace ││ blog - 0 a database for a blog, dropped with its instance ││ bookmarks latest 1 sync browser bookmarks ││ broken-link-checker latest 1 finds broken links and missing images ││ builder v1.32.0 6 low-code page builder ││ builder v1.32.0 6 low-code page builder ││ calendar latest 1 CalDAV-based calendar management ││ checksum latest 1 compute a hash checksum of a file ││ classic-editor latest 1 restores the previous (TinyMCE) editor ││ classic-widgets latest 1 restores the pre-block widget screens ││ code-snippets latest 1 runs PHP snippets without editing functions.php ││ contact-form-7 latest 1 contact form management ││ contacts latest 1 CardDAV address book ││ crm v1.81.0 4 sales pipeline and customer relationships ││ crm v1.81.0 4 sales pipeline and customer relationships ││ custom-post-type-ui latest 1 admin UI for custom post types and taxonomies ││ daggerhart-openid-connect-generic latest 1 SSO via OIDC (used with Keycloak) ││ deck latest 1 kanban-style project management ││ disable-comments latest 1 turns comments off globally or per post type ││ drawio latest 1 create and edit draw.io diagrams and whiteboards in Nextclo… ││ duplicate-post latest 1 clones a post or page, with rewrite and republish ││ duplicator latest 1 site backup, clone and migration bundles ││ ecommerce_integrations v1.20.3 4 Shopify, Amazon, Unicommerce │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <addon>$ tmux send-keys -t hud ':contexts' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <d> Describe <y> YAML Cluster: 2 nodes <e> Edit Deployments: 9 (9 healthy) <?> Help Tenant: prod <ctrl-n> New Stack: all <ctrl-d> Remove Environment: all <u> Use shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── contexts(all)[1] ──────────────────────────────────────────────────────────────────────┐│ NAME↑ COMMAND TRANSPORT DEFAULT ACTIVE ││ shc (embedded) stdio * * ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <context>$ tmux send-keys -t hud C-n$ tmux capture-pane -pt hud# x9s: editing context/new. Save to apply, quit unchanged to abort.# A new x9s context: one configured provider, saved to the registry# (~/.config/x9s/providers.json). The name is what ':ctx' will show and# what 'x9s -- <name>' will launch.name: ""
# command: the provider executable. A bare name is resolved through $PATH# and then as x9s-<name>, so "docker" finds x9s-docker; an absolute path is# taken as-is.command: ""
# args: passed to the provider on every launch.
# env: extra KEY=VALUE for the provider process only. Use this for tokens# rather than exporting them into every shell you start x9s from.# env: ["GITLAB_TOKEN=glpat-..."]
# transport: stdio (default) or unix.# transport: stdio
# socket: unix CONNECT mode: dial an already-running provider instead of# spawning one. Set transport to unix when you use this.# socket: /run/shc/shc.sock
# default: make this the provider x9s launches when none is named.# default: true~~~~~~~~~~~~~~~~"/tmp/x9s-edit-3637659300.yaml" 27L, 1014B 1,1 All$ tmux send-keys -t hud ':q!' Enter$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <d> Describe <y> YAML Cluster: 2 nodes <e> Edit Deployments: 9 (9 healthy) <?> Help Tenant: prod <ctrl-n> New Stack: all <ctrl-d> Remove Environment: all <u> Use shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── contexts(all)[1] ──────────────────────────────────────────────────────────────────────┐│ NAME↑ COMMAND TRANSPORT DEFAULT ACTIVE ││ shc (embedded) stdio * * ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <context>$ tmux send-keys -t hud 'g' 'u' C-d$ tmux capture-pane -pt hud Daemon: unix:/run/shc/shc.sock (--dae… <d> Describe <y> YAML Cluster: 2 nodes <e> Edit Deployments: 9 (9 healthy) <?> Help Tenant: prod <ctrl-n> New Stack: all <ctrl-d> Remove Environment: all <u> Use shc9s Rev: 0.1.2┌────────────────────────────────────────────────────────────────────── contexts(all)[1] ──────────────────────────────────────────────────────────────────────┐│ NAME↑ COMMAND TRANSPORT DEFAULT ACTIVE ││ shc (embedded) stdio * * ││ ││ ││ ││ ││ ││ ││ ┌──────────────<Confirm Write shc>──────────────┐ ││ │ │ ││ │ Remove context shc │ ││ │ │ ││ │ This forgets how to reach that provider. │ ││ │ The provider executable itself is left alone. │ ││ │ │ ││ │ │ ││ │ Cancel Confirm Write │ ││ │ │ ││ └───────────────────────────────────────────────┘ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ ││ │└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ <context>$ tmux send-keys -t hud Escape$ tmux send-keys -t hud C-cEvery table the HUD serves has now been opened, every key it binds pressed and every verb of every menu opened. This page confirmed only a backup verify, a backup mount and its umount, a repo sync, a quota disk scan, a job run and a doctor run; the cluster holds what the nodes page left.
The seeing ladder ends here. The cluster ladder picks the deployments up where the drain left them.