Self-hosted zero-downtime deployment engine. Push to GitHub → VersionGate pulls the source, builds a Docker image, spins up the new container, switches Nginx traffic, and tears down the old one — all without a single second of downtime.
Built for single-server (KVM/VPS) setups where you want Vercel-style deployments on your own hardware.
- Blue-green deployments — every project gets two container slots (blue/green). Deploys always target the idle slot; live traffic is never touched until the new container is confirmed healthy.
- Webhook auto-deploy — add your project's webhook URL to GitHub and every push to the configured branch triggers a deploy automatically.
- One-click rollback — restore the previous deployment instantly via the dashboard or API.
- Crash recovery — on restart, stale
DEPLOYINGrecords are markedFAILEDand orphaned containers are cleaned up automatically. - AI CI pipeline generation — generate a GitHub Actions workflow for any project with a single API call (requires Gemini API key).
| Layer | Technology |
|---|---|
| Runtime | Bun 1.x + TypeScript |
| API server | Fastify |
| Database | PostgreSQL via Prisma (Neon serverless supported) |
| Containers | Docker CLI |
| Proxy | Nginx upstream config management |
| Process manager | PM2 |
| Dashboard | Next.js (static export, served by Fastify) |
- Bun ≥ 1.0
- Docker (running)
- Nginx (installed)
- PostgreSQL — local or Neon free tier
- PM2 —
npm i -g pm2
git clone https://github.com/dinexh/VersionGate
cd VersionGate
bun install
cd dashboard && bun install && bun run build && cd ..pm2 start ecosystem.config.cjs
pm2 saveNavigate to http://your-server-ip:9090/setup in your browser.
Fill in your domain, PostgreSQL connection string, and optional Gemini API key — the wizard writes the config, migrates the database, and configures Nginx automatically. The engine restarts itself and redirects you to the dashboard.
- Setup & API — detailed setup, environment variables, full API reference
- Architecture — deployment pipeline, blue-green state diagrams, rollback flow, crash recovery