Deploy an app to Wokku in under 5 minutes.
Prerequisites
- A Wokku account (sign up)
- A connected server (connect one)
Deploy from a Template
The fastest way to get started — deploy a pre-configured app with one click.
- Go to Templates in the sidebar
- Browse or search for an app (e.g., Ghost, Uptime Kuma, n8n)
- Click Deploy
- Select your server and give the app a name
- Click Deploy — Wokku handles the rest
# List available templates
wokku templates
# Deploy one
wokku deploy ghost –server my-server –name my-blog
curl -X POST https://wokku.cloud/api/v1/templates/deploy \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"slug": "ghost", "server_id": 1, "name": "my-blog"}'
Ask Claude: “Deploy a Ghost blog called my-blog on server 1”
Tap Templates in the bottom nav, find Ghost, tap Deploy, select your server, and confirm.
Deploy from GitHub
Connect a repo and deploy automatically on every push.
- Go to Apps → New App
- Click Connect GitHub
- Select your repository and branch
- Click Create — Wokku builds and deploys your app
- Future pushes to that branch auto-deploy
wokku apps:create my-app --server my-server
wokku github:connect my-app --repo your-org/your-repo --branch main
curl -X POST https://wokku.cloud/api/v1/apps \
-H "Authorization: Bearer $TOKEN" \
-d '{"name": "my-app", "server_id": 1}'
Ask Claude: “Create an app called my-app on server 1”
Then connect GitHub from the dashboard (OAuth flow).
Tap + on the Apps screen, enter a name, select server. GitHub connection is available from the app detail screen.
Deploy with Git Push
Push to Wokku’s SSH git gateway — it routes your push to the right Dokku
host automatically. First, register your SSH public key under
Profile → SSH Keys so the gateway recognizes you.
After creating an app, copy the git remote URL from the app’s overview page:
git remote add wokku git@wokku.cloud:my-app
git push wokku main
On self-hosted installs, the gateway host is whatever you configured
viaWOKKU_GIT_HOST(defaults towokku.cloud). You can also push
directly withgit remote add dokku dokku@<server>:my-appif the
gateway isn’t set up yet.
wokku apps:create my-app --server my-server
# Copy the git URL from the output, then:
git remote add wokku git@wokku.cloud:my-app
git push wokku main
Create the app via API, then use git push to deploy:
curl -X POST https://wokku.cloud/api/v1/apps \
-H "Authorization: Bearer $TOKEN" \
-d '{"name": "my-app", "server_id": 1}'
git remote add wokku git@wokku.cloud:my-app
git push wokku main
Ask Claude: “Create an app called my-app on server 1”
Then push with git:
git remote add wokku git@wokku.cloud:my-app
git push wokku main
Create the app from Mobile, then use git push from your terminal.