Cluster Setup
Operator documentation for deploying and running a private abc-cluster instance.
abc-cluster is available in three tiers that describe the scale and feature surface of a deployment:
| Tier | Scale | Access management | Object storage |
|---|---|---|---|
| Seedling | Single node or small cluster | Claim-code pool (SQLite) | MinIO |
| Grove | Multi-node, multi-institution | Managed accounts | MinIO / S3 |
| Garden | Federation, cloud-hybrid | Full IAM | Cloud-native |
This documentation covers the seedling tier. Grove and garden are in progress.
Seedling tier pages
| Page | Summary |
|---|---|
| Seedling overview | Architecture, phased checklist, namespace layout |
| Phase 1 — Bare Nomad | Install Nomad, bootstrap ACL, verify |
| Phase 2 — Pulumi bootstrap | Deploy the full abc-seedling stack via Pulumi |
| Phase 3 — Provision access pool | Mint tokens and populate the claim database |
| Phase 4 — Deploy landing page | Run deploy-landing.sh; go live |
| Reverse proxy / TLS (optional) | Caddy for internet-facing clusters; plain HTTP for LANs |
| Issuing handover files | Export config.yaml snippets for named users |
Looking for the CLI docs? The Cluster CLI section covers the
abccommand-line tool — installation, the command structure, and the full reference. Start at CLI → Overview.