GitHub Integration

Connect your GitHub account to deploy private repositories and enable auto-deploy on push.

Connecting GitHub

1. Go to Settings → Integrations or click "Connect GitHub" when adding a service
2. You'll be redirected to GitHub to install the ZevCloud app
3. Choose which repositories to grant access to (or all)
4. After installation, you're redirected back to ZevCloud

Organizations

You can connect multiple GitHub accounts and organizations:

1. Go to Settings → Integrations
2. Click "Add GitHub Account"
3. Select the organization to install on

Each installation is listed separately. When creating a service, you can switch between accounts.

Auto-Deploy on Push

When enabled (default), every push to the configured branch triggers a deployment:

1. You push code to GitHub
2. GitHub sends a webhook to ZevCloud
3. ZevCloud starts a build
4. If successful, the new version goes live
5. Email notification sent (success or failure)

Disabling Auto-Deploy

Go to Service Settings → Build & Deploy and toggle off auto-deploy. You can still deploy manually from the dashboard or CLI.

Private Repository Access

ZevCloud uses the GitHub App's installation token to clone private repositories. You don't need to share SSH keys or personal access tokens.

The token is refreshed automatically before each deployment.