Connect a GitHub repository to deploy automatically on every push.
Connect a Repository
- Go to your app’s detail page
- Click Connect GitHub
- Authorize the Wokku GitHub App (first time only)
- Select your repository and branch
- 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
- You push code to the connected branch
- GitHub sends a webhook to Wokku
- Wokku triggers a deploy on your Dokku server
- 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.cloud/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.cloud/api/v1/apps/my-app/github \
-H "Authorization: Bearer $TOKEN"
Ask Claude: “Disconnect GitHub from my-app”
Tap your app → Settings → Disconnect GitHub.