Self-Hosting
Run the full SteerPlane stack — API, dashboard, Postgres, and Redis — with Docker.
SteerPlane is open-source (MIT) and self-hostable. The full stack runs with Docker Compose: the FastAPI control plane, the Next.js dashboard, PostgreSQL, and Redis.
Clone the repo
git clone https://github.com/vijaym2k6/SteerPlane.git
cd SteerPlaneConfigure environment
cp .env.example .env
# set DATABASE_URL, STEERPLANE_ADMIN_TOKEN, SMTP_*, CORS_ORIGINS as neededBring up the stack
docker compose up -d| Service | URL |
|---|---|
| API + gateway | http://localhost:8000 |
| API docs (OpenAPI) | http://localhost:8000/docs |
| Dashboard | http://localhost:3000 |
Manual (without Docker)
# API
cd api && pip install -r requirements.txt && alembic upgrade head
uvicorn app.main:app --reload
# Dashboard
cd dashboard && npm install && npm run devDatabase
SQLite is the default for local development (sqlite:///./steerplane.db); set DATABASE_URL to a
PostgreSQL DSN for production. Schema changes are managed with Alembic migrations.
Point your SDK or gateway client at your own deployment by setting STEERPLANE_API_URL (or
api_url in .steerplane.yml).