Create an App

Create a new application on one of your connected servers.

Create

Web UI

1. Go to Apps → New App
2. Enter an app name (lowercase, alphanumeric, hyphens allowed)
3. Select the server to deploy on
4. Optionally set the deploy branch (default: main)
5. Click Create

CLI

wokku apps:create my-app --server my-server

Options:

• --server — server name or ID (required)
• --branch — deploy branch (default: main)

API

curl -X POST https://wokku.cloud/api/v1/apps \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app", "server_id": 1, "deploy_branch": "main"}'

MCP

Ask Claude: “Create an app called my-app on server 1”

Mobile

Tap + on the Apps screen, enter a name, select your server, and tap Create.

App Naming Rules

• Lowercase letters, numbers, and hyphens only
• Must start with a letter
• 3-30 characters
• Must be unique per server

After Creation

Your app is created but not yet deployed. Next steps:

1. Deploy your code via git push or GitHub
2. Set environment variables for your app
3. Add a custom domain
4. Add a database if needed