alpstack¶
alpstack is a small, affordable, self-hosted Kubernetes platform that runs openDesk in production. It's built from four tightly-coupled, public Git repositories, reconciled by GitOps on a hardened Talos cluster.
This site is the umbrella documentation for the whole platform. Each layer also has its own repository (with a README and wiki) for the fine detail.
The four layers¶
| Layer | Repo | Role |
|---|---|---|
| 1 · OS | talos-cluster | Boots a hardened, encrypted Talos cluster from scratch |
| 2 · Platform | platform-argocd | Networking, storage, certificates, monitoring, secrets |
| 3 · Addons | addons-argocd | Add-ons (NetBird remote access, Vaultwarden, …) |
| 4 · openDesk | opendesk-argocd | openDesk + its production-grade backing services |
Start here¶
- Architecture — how the four layers and three ArgoCD instances fit together.
- Operations — everyday GitOps tasks (validate, render, sync, add an app).
- Deploy your own — stand up your own alpstack from scratch.
- Runbooks · Reference
Contributing
Every page lands via a reviewed pull request against the
alpstack/docs repo, sanitized to be specifics-free
(no hostnames, IPs, or secrets). The per-repo wikis have been retired in favour of this site.