One node to learn on
Use one fresh Debian 13 machine with SHC installed and a root shell. It needs
2 CPUs and 8 GB of memory. Name it home01; it belongs to location home in
cloud learn. This ladder runs on that one machine until a page needs a
second one, and that page says which machine to add and why.
P@ssw0rd is the example vault password throughout this ladder. Use this
machine only for learning.
Initialize home01 and start the 30-day trial. shc init installs the cluster’s
own modules; on a node with 2 CPUs it skips openobserve, which needs 3, and
says so.
$ shc init --name home01 --cloud learn --location home --vault-password P@ssw0rd --yesDNS ownership identity for this cluster: shc-dee0281b, stored in dns.owner_idbackup repository key generated and sealed at vault backup/passwordbackup.password = ref+vault://backup/passwordbackup.repo is not set: shc backup create refuses until it iswarning: skipped 1 module, no node is big enough for them: [X200916SYSCAP] module openobserve needs 3 CPUs for service openobserve but no node measured more than 2. openobserve was skipped. shc reconcile installs it once a node with the capacity has joinedinstalling modules postgres, keycloak, traefik for tenant "master"[postgres] Healthy 1/1✔ postgres-1 healthy[keycloak] Healthy 1/1✔ keycloak healthy[traefik] Healthy 3/3✔ forward-auth healthy✔ traefik healthy✔ traefik-init healthyadded repository shc from https://selfhostedcloud.org/apps/0.1/index.yaml✔ initialized cluster on node "home01" with runtime docker$ shc license statusstate: unlicensed
capacity: now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0 term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0 term began: 2026-11-06T17:38:05Z$ shc license trial start30-day trial started: Hobby tier.ends: 2026-12-07T19:58:55Z, when Hobby growth stops; everything you built keeps runninglocks: 2026-12-21T19:58:55Z, after the 14-day grace period. Every estate change is then refused: installs, updates, config and cluster changes, and backup create/restore. No container is ever stopped and existing backups stay downloadable. An estate that never starts a trial is never locked. Activate a license before then to clear it; `shc license status` shows where you stand.$ shc license statusstate: trialtrial ends: 2026-12-07T19:58:55Z
capacity: licensed: max_nodes=1 now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0 term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0 term began: 2026-11-07T19:50:01ZA new cluster holds one tenant, master, and SHC’s own modules live there.
Add prod, the tenant this ladder’s apps go in, and select it with
shc ctx -t. Every later command on home01 then reads prod without naming
it. --no-admin leaves the tenant’s Keycloak realm without users; the access
ladder adds them. The realm finishes in the background.
$ shc tenant add prod --no-admin✔ created tenant "prod"warning: keycloak realm provisioning still in progress$ shc ctx -t prod...Run these commands again if home01 is still vault-locked or not ready.
$ shc node lsNAME STATE CONDITION AVAIL CLOUD LOCATION ROOM BUILD STORE LEADER VOTERhome01 healthy ready active learn learn/home ok 0.1.47 voter yes yes$ shc cluster statuscluster name: shc-clusterleader: home01nodes: 1 healthy of 1voters: 1quorum: healthy, 1 voter requiredleader-only work, recorded by home01 2s ago: acme last swept 17s ago app_refinish last swept 17s ago backup_scheduler running 7m17s, no sweep yet container_reconciler last swept 16s ago mesh_snapshot_sign last swept 7s ago operation_registry last swept 17s ago proxy_reconcile last swept 17s ago schedule_dispatcher last swept 17s ago scheduler last swept 2s ago service_vip_alloc last swept 7s ago$ shc tenant lsACTIVE NAME DEPLOYMENTS master 3* prod 0$ shc lsno deployments in tenant "prod"; there are 3 in masterOne node is a whole cluster: it leads, it is the only voter, and it runs
every deployment. shc cluster status ends with the work only the leader
does. The platform apps belong to master. shc tenant ls marks the
selected tenant with *, and shc ls lists its deployments. Leave prod
selected.
Next: A compose file.