Auto-Deploy

Automatically deploy your application when you push code to GitHub.

How It Works

You push to main branch
    ↓
GitHub sends webhook to ZevCloud
    ↓
ZevCloud clones the latest code
    ↓
Nixpacks detects language/framework
    ↓
Docker image built on build server
    ↓
Container deployed to production server
    ↓
Traffic routed to new version
    ↓
Email notification sent

Supported Triggers

Trigger	When
Push to branch	Any push to the configured branch (e.g., `main`)
Manual deploy	Click “Deploy” in dashboard or `zevcloud deploy`
API trigger	`POST /v1/services/:id/deployments`

Configuration

Auto-deploy is enabled by default when you connect a GitHub repository. Configure in Service Settings:

Branch — which branch triggers auto-deploy
Root Directory — if your app is in a monorepo subdirectory
Auto-Deploy Toggle — enable/disable

Build Settings

Customize the build process:

Setting	Default	Description
Build Pack	Nixpacks (auto)	Auto-detects your language
Build Command	Auto-detected	e.g., `npm run build`
Install Command	Auto-detected	e.g., `npm ci`
Start Command	Auto-detected	e.g., `npm start`
Output Directory	Auto-detected	e.g., `.next`, `dist`

Deployment Notifications

Email notifications are sent for:

✅ Deployment succeeded
❌ Deployment failed (with error summary)

Configure notification preferences in Settings → Notifications.