README
¶
Ship using agents, the Canvas, or the CLI. Self-host it, or run on our cloud.
Quickstart · Docs · Website · Discord
What is Stackdome
Stackdome is an open-source, self-hostable alternative to Railway, Render, and Heroku.
Your whole application, described once and shipped as one unit: the services, the databases, the storage they sit on. Stackdome takes it from a git push or a container image to a live release.
The delivery layer comes with it: builds, managed Postgres with backups, TLS, a full preview environment per branch, and a way back to any previous release. Drive it from your coding agent, the Canvas, or the CLI, on our cloud or your own compute.
Three ways in
One application model, three surfaces. Use whichever fits the moment.
From your coding agent
Install the Stackdome skill, or point your agent at agents.stackdome.com. Your agent gets the full delivery loop: create stacks, deploy, tail releases, and debug from a prompt.
npx skills add stackdome/stackdome-skills
Then, in your agent:
Deploy this repo to Stackdome and give me the live URL.
From the Canvas
Compose services, databases, and volumes visually. Every change is a reviewable diff: apply, deploy, and watch it go live.
From the CLI
Scaffold a stackfile, deploy, and watch the release converge. Then check status or open the live app straight from the terminal.
curl -fsSL https://get.stackdome.com/cli.sh | sh
stackdome init
stackdome deploy --wait
stackdome status
stackdome open
Features
- Many services, one stack: deploy an entire application as a single unit
- Bring your own compute: connect your clusters or start on a fresh VPS
- Managed Postgres: HA, automated backups, and point-in-time restore
- Git to live app: build from any git repo, or deploy any container image
- Declarative in one file: the whole stack in a reviewable
stackfile.yaml - Every change is a diff: releases are proven live and healthy before they count
- Roll it back: one command back to any previous release
- Unlimited preview environments: a full stack per branch or pull request
- Any image registry: public or private, or the built-in per-cluster registry
- Observability built in: live logs, metrics, and release timelines
Get started
Cloud (alpha): Start on the cloud. Alpha is open while capacity lasts.
Self-host:
curl -fsSL https://get.stackdome.com/install.sh | sudo sh
Runs on Kubernetes v1.27+ (EKS, GKE, AKS, k3s) or a fresh VPS with 2 vCPU / 4 GB. Full walkthrough: Self-host guide.
Documentation
- Quickstart: first deploy in 10 minutes
- Self-hosting
- Stackfile reference
- API reference: generated from the repo's OpenAPI spec
Repositories
| Repo | What it is |
|---|---|
| stackdome | This repo, the hub: API server, web UI, and docs |
| cluster-agent | Kubernetes operator that runs on each connected cluster |
| stackdome-cli | The stackdome command-line interface |
Community & contributing
- Discord: questions, feedback, launch chatter
- Issues: bugs and feature requests
- DEVELOPMENT.md: build and hack on Stackdome itself
Directories
¶
| Path | Synopsis |
|---|---|
|
installer
command
|
|
|
pkg
|
|
|
auth
Package auth is a generated GoMock package.
|
Package auth is a generated GoMock package. |
|
clients/githubapp
Package githubapp is a thin GitHub App API client covering the manifest conversion, installation, and repository discovery flows.
|
Package githubapp is a thin GitHub App API client covering the manifest conversion, installation, and repository discovery flows. |
|
clients/turnstile
Package turnstile verifies Cloudflare Turnstile challenge tokens.
|
Package turnstile verifies Cloudflare Turnstile challenge tokens. |
|
controllers/imagebuild
Package imagebuild is a generated GoMock package.
|
Package imagebuild is a generated GoMock package. |
|
controllers/stackresource
Package stackresource is a generated GoMock package.
|
Package stackresource is a generated GoMock package. |
|
credentials
Package credentials defines the credential-resolution seam shared by the service layer and its consumers (validators, workers).
|
Package credentials defines the credential-resolution seam shared by the service layer and its consumers (validators, workers). |
|
handlers
Package handlers is a generated GoMock package.
|
Package handlers is a generated GoMock package. |
|
mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
services
Package services is a generated GoMock package.
|
Package services is a generated GoMock package. |
|
services/clusterresource
Package clusterresource is a generated GoMock package.
|
Package clusterresource is a generated GoMock package. |
|
signupprotection
Package signupprotection applies bot verification and bounded throttles to public password signup.
|
Package signupprotection applies bot verification and bounded throttles to public password signup. |
|
stackdeploy
Package stackdeploy converts a draft stack (user-authored state from the DB) into an effective stack: connections, self outputs, and volume relationships resolved into the concrete values the cluster CR builder consumes.
|
Package stackdeploy converts a draft stack (user-authored state from the DB) into an effective stack: connections, self outputs, and volume relationships resolved into the concrete values the cluster CR builder consumes. |
|
web
Package web embeds the built React SPA into the api-server binary.
|
Package web embeds the built React SPA into the api-server binary. |
|
worker/release
Package release is a generated GoMock package.
|
Package release is a generated GoMock package. |
|
worker/stack
Package stack is a generated GoMock package.
|
Package stack is a generated GoMock package. |
|
test
|
|