GitHub Auto-Deploy

Connect a GitHub repository to deploy automatically on every push.

Connect a Repository

Web UI

1. Go to your app’s detail page
2. Click Connect GitHub
3. Authorize the Wokku GitHub App (first time only)
4. Select your repository and branch
5. Click Connect

CLI

wokku github:connect my-app --repo your-org/your-repo --branch main

API

GitHub connection requires OAuth — use the Web UI for initial setup.

MCP

Initial GitHub authorization requires the Web UI.

Mobile

Tap your app → GitHub to connect a repository.

How It Works

1. You push code to the connected branch
2. GitHub sends a webhook to Wokku
3. Wokku triggers a deploy on your Dokku server
4. Build output streams in real-time

Change Deploy Branch

Web UI

Go to your app → Settings → GitHub and change the deploy branch.

CLI

wokku apps:update my-app --branch develop

API

curl -X PUT https://wokku.cloud/api/v1/apps/my-app \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"deploy_branch": "develop"}'

MCP

Ask Claude: “Change my-app deploy branch to develop”

Mobile

Tap your app → Settings → change the branch.

Disconnect

Web UI

Go to your app → Settings → GitHub → Disconnect.

CLI

wokku github:disconnect my-app

API

curl -X DELETE https://wokku.cloud/api/v1/apps/my-app/github \
  -H "Authorization: Bearer $TOKEN"

MCP

Ask Claude: “Disconnect GitHub from my-app”

Mobile

Tap your app → Settings → Disconnect GitHub.