Your First Deploy
Deploy an app to Wokku in under 5 minutes.
Prerequisites
Section titled “Prerequisites”- A Wokku account (sign up)
- A connected server (connect one)
Deploy from a Template
Section titled “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 templateswokku templates
# Deploy onewokku deploy ghost --server my-server --name my-blogcurl -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
Section titled “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-serverwokku github:connect my-app --repo your-org/your-repo --branch maincurl -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
Section titled “Deploy with Git Push”Push directly to your Dokku server.
After creating an app, copy the git remote URL from the app’s overview page:
git remote add dokku dokku@your-server:my-appgit push dokku mainwokku apps:create my-app --server my-server# Copy the git URL from the output, then:git remote add dokku dokku@your-server:my-appgit push dokku mainCreate 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 dokku dokku@your-server:my-appgit push dokku mainAsk Claude: “Create an app called my-app on server 1”
Then push with git:
git remote add dokku dokku@your-server:my-appgit push dokku mainCreate the app from Mobile, then use git push from your terminal.