GitHub Auto-Deploy

Connect your GitHub repository to automatically deploy your app on every push.

Setup

1. Go to Services > PaaS > Your App > GitHub
2. Enter your repository URL (e.g., https://github.com/username/repo)
3. Select the branch to deploy (default: main)
4. Enable Deploy on Push
5. Click Connect

How It Works

You push to GitHub → Webhook fires → Platform pulls code → Builds → Deploys → Live

The entire process takes under 60 seconds for most apps.

What Gets Deployed

• The platform clones your repository
• Detects your language (Node.js, Python, Go, etc.)
• Installs dependencies
• Builds your application
• Runs health checks
• Switches traffic to the new version (zero-downtime)

Build Logs

Watch your deployment in real-time:

1. Go to Deploys tab
2. Click on the latest deployment
3. View build output as it happens

Manual Deploy

Trigger a deploy manually without pushing code:

• Go to the GitHub tab
• Click Deploy Now

Disconnect

To stop auto-deploys:

• Go to the GitHub tab
• Click Disconnect

Your app keeps running — it just won't auto-deploy on push anymore. You can reconnect anytime.

SSH Key Deploy (Alternative)

If you prefer git push instead of GitHub:

1. Go to SSH Keys tab
2. Add your public key
3. Then: git push dokku main

Both methods can coexist — use GitHub for main branch, SSH for hotfixes.