Public Beta
Wokku | Docs
/
Sign In

GitHub Auto-Deploy

Connect a GitHub repository to deploy automatically on every push.

#Connect a Repository

  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
bash
wokku github:connect my-app --repo your-org/your-repo --branch main

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

Initial GitHub authorization requires the Web UI.

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

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

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

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

Tap your app → Settings → change the branch.

#Disconnect

Go to your app → Settings → GitHub → Disconnect.

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

Ask Claude: “Disconnect GitHub from my-app”

Tap your app → Settings → Disconnect GitHub.