Create & Link Add-ons

Enable shared add-ons on a box at creation or later; upgrade to dedicated from the box settings tab. Full CLI, API, and MCP reference.

Wokku add-ons work at the box level, not as standalone resources. You pick which shared engines to enable per box at creation, and you can add or remove them later from the box settings.

Enable shared add-ons at box creation

Go to Boxes → New Box. Under Add-ons, check the engines you want. Free plan boxes only show Postgres and Redis; paid plans show all five.

bash

# Enable Postgres and Redis when creating the box wokku apps:create my-app --shared postgres,redis

# Enable all five (Solo+ only) wokku apps:create my-app –shared postgres,redis,memcached,rabbitmq,meilisearch

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": "SERVER_ID",
    "shared_addons": ["postgres", "redis"]
  }'

Enable a shared add-on later

Go to the box → Settings → Add-ons → toggle the engine on.

bash

wokku addons:shared:enable my-app postgres
wokku addons:shared:enable my-app redis
wokku addons:shared:enable my-app memcached
wokku addons:shared:enable my-app rabbitmq
wokku addons:shared:enable my-app meilisearch

Tool: wokku_enable_shared_addon
Arguments: { "app_id": "APP_ID", "engine": "postgres" }

Disable a shared add-on

Disabling removes the tenant and injects null into the env var. Your data is kept for 24 hours; re-enabling within that window restores it.

Go to box → Settings → Add-ons → toggle the engine off → confirm.

Tool: wokku_disable_shared_addon
Arguments: { "app_id": "APP_ID", "engine": "postgres" }

Upgrade a shared add-on to dedicated

Upgrading provisions a single-tenant container, migrates data (for Postgres and Redis), flips the connection URL, and restarts the box. Uses one slot from your plan’s dedicated quota. See Dedicated upgrade for the full flow.

Go to box → Settings → Add-ons → click Upgrade to dedicated next to the engine.

bash

# Upgrade shared Postgres to dedicated wokku addons:dedicated:upgrade my-app postgres # Upgrade shared Redis to dedicated wokku addons:dedicated:upgrade my-app redis

# Add MySQL or MongoDB (fresh-create; no shared equivalent) wokku addons:dedicated:upgrade my-app mysql wokku addons:dedicated:upgrade my-app mongodb

Tool: wokku_upgrade_dedicated_addon
Arguments: { "app_id": "APP_ID", "engine": "postgres" }

Connection URL env vars

When an add-on is enabled, Wokku injects the connection URL into the box’s environment. The same var name is used whether the engine is shared or dedicated.

Engine	Env var
PostgreSQL	`DATABASE_URL`
MySQL	`DATABASE_URL`
MongoDB	`MONGO_URL`
Redis	`REDIS_URL`
Memcached	`MEMCACHED_URL`
RabbitMQ	`RABBITMQ_URL`
Meilisearch	`MEILISEARCH_URL`

# Create & Link Add-ons

Enable shared add-ons at box creation

Enable a shared add-on later

Disable a shared add-on

Upgrade a shared add-on to dedicated

Connection URL env vars

See also