Skip to content
SHC Docs

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.

home01
$ tmux new -d -s hud -x 160 -y 44 -e EDITOR=vi shc hud

: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.

home01
$ 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>
home01
$ tmux send-keys -t hud ':apps' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'nextcloud' Enter
$ tmux send-keys -t hud 'j'
$ tmux send-keys -t hud 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'j'
$ tmux send-keys -t hud 'i'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'j'
$ tmux send-keys -t hud Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'i'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':repos' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'a'
home01
$ 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>
home01
$ tmux send-keys -t hud Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'e'
home01
$ tmux capture-pane -pt hud
# x9s: editing repos/system/system/shc. Save to apply, quit unchanged to abort.
app_count: 460
created_at: "2026-10-09T08:09:32.737125712Z"
environment: system
id: 2
name: shc
priority: 50
synced_at: "2026-10-09T08:43:13.722155789Z"
tenant_name: system
updated_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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape

Backups, 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.

home01
$ tmux send-keys -t hud ':backups' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'a'
home01
$ 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>
home01
$ tmux send-keys -t hud Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'a' Down Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'a' Down Down Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'v' 'm'
home01
$ 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.

home01
$ tmux send-keys -t hud 'c' 'a' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'w'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ 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.

home01
$ tmux send-keys -t hud ':volumes' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':volumemounts' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':storage' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'e'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'l'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':exports' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'R'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape

: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.

home01
$ tmux send-keys -t hud ':backupkeys' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'n'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'g' C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':retention' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'e'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 't'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape

: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.

home01
$ tmux send-keys -t hud ':secrets' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'backup' Enter C-w
home01
$ 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>
home01
$ tmux send-keys -t hud 'x'
$ tmux send-keys -t hud 'x'
$ tmux send-keys -t hud 'c' C-w
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'a' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ 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.

home01
$ tmux send-keys -t hud ':vault' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'U'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'n'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'M'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'w'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'R'
home01
$ 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>
home01
$ 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.

home01
$ tmux send-keys -t hud ':config' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'backup.repo' Enter 'c' 'e'
home01
$ tmux capture-pane -pt hud
# x9s: editing config/global////backup.repo. Save to apply, quit unchanged to abort.
environment: ""
path: backup.repo
scope: global
stack_name: ""
tenant_name: prod
value: /var/backups/shc/repo
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
~
"/tmp/x9s-edit-522966803.yaml" 7L, 195B 1,1 All
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'a' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-u

Quotas, 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.

home01
$ tmux send-keys -t hud ':quotas' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'a' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':tenants' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'prod' Enter C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'v' 'u'
home01
$ 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>
home01
$ 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'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-u ':users' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':connections' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':integrations' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud 'g' C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape

: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.

home01
$ tmux send-keys -t hud ':ingress' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'c' 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':dns' Enter
home01
$ 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 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.

home01
$ tmux send-keys -t hud ':schedules' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':jobs' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'disable-maintenance-mode' Enter
$ tmux send-keys -t hud 't'
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-k
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-u 'v' 'h'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':runs' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':crons' Enter
home01
$ 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.

home01
$ tmux send-keys -t hud ':audit' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':certificates' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':license' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 't'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-n
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud ':notifications' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':diagnoses' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud '/' 'database.orphaned-dirs' Enter 't'
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud Tab Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'd'
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-u

: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.

home01
$ tmux send-keys -t hud ':types' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud ':contexts' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud C-n
home01
$ 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.
# args: ["-dsn", "postgres://user:[email protected]:5432/app"]
# 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
home01
$ tmux send-keys -t hud ':q!' Enter
home01
$ 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>
home01
$ tmux send-keys -t hud 'g' 'u' C-d
home01
$ 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>
home01
$ tmux send-keys -t hud Escape
$ tmux send-keys -t hud C-c

Every 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.