Skip to content
SHC Docs

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.

home01
$ shc init --name home01 --cloud learn --location home --vault-password P@ssw0rd --yes
DNS ownership identity for this cluster: shc-dee0281b, stored in dns.owner_id
backup repository key generated and sealed at vault backup/password
backup.password = ref+vault://backup/password
backup.repo is not set: shc backup create refuses until it is
warning: 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 joined
installing 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 healthy
added repository shc from https://selfhostedcloud.org/apps/0.1/index.yaml
✔ initialized cluster on node "home01" with runtime docker
$ shc license status
state: 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 start
30-day trial started: Hobby tier.
ends: 2026-12-07T19:58:55Z, when Hobby growth stops; everything you built keeps running
locks: 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 status
state: trial
trial 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:01Z

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

home01
$ 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.

home01
$ shc node ls
NAME STATE CONDITION AVAIL CLOUD LOCATION ROOM BUILD STORE LEADER VOTER
home01 healthy ready active learn learn/home ok 0.1.47 voter yes yes
$ shc cluster status
cluster name: shc-cluster
leader: home01
nodes: 1 healthy of 1
voters: 1
quorum: healthy, 1 voter required
leader-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 ls
ACTIVE NAME DEPLOYMENTS
master 3
* prod 0
$ shc ls
no deployments in tenant "prod"; there are 3 in master

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