Create a new application on one of your connected servers.
Create
- Go to Apps → New App
- Enter an app name (lowercase, alphanumeric, hyphens allowed)
- Select the server to deploy on
- Optionally set the deploy branch (default:
main) - Click Create
bash
wokku apps:create my-app --server my-server
Options:
--server— server name or ID (required)--branch— deploy branch (default: main)
bash
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"}'
Ask Claude: “Create an app called my-app on server 1”
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:
- Deploy your code via git push or GitHub
- Set environment variables for your app
- Add a custom domain
- Add a database if needed