Skip to content

Configuration

App settings can be changed without redeploying — the app keeps running while the platform applies the new configuration. You can edit settings from the dashboard or via PUT /apps.

Open the app in Apps, then edit its settings. The same fields you chose at deploy time are available: size, instances, ports, environment variables, volumes, labels, and the sleep-when-idle / run-once toggles. Changes apply live — no redeploy.

PUT /apps fully replaces the app’s configuration, so include all fields. The body must include the app’s id:

Terminal window
curl -X PUT https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "id": "<app-id>", "project_id": "…", "name": "my-api", "image": "docker.io/nginx:latest", "ports": [{ "name": "web", "number": 80 }], "cpu": 400, "memory": 1024, "instances": 3, "hibernated": false }'

Change the size by setting cpu (millicores) and memory (MB). See Resource tiers for the size ladder:

Terminal window
curl -X PUT https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "id": "<app-id>", "project_id": "…", "name": "my-api", "image": "docker.io/nginx:latest", "ports": [{ "name": "web", "number": 80 }], "cpu": 700, "memory": 2048, "instances": 1, "hibernated": false }'

Set instances to run more or fewer replicas (1–10).

Set hibernated: true to sleep the app and release its resources; set it back to false to wake it. See Apps.

Add, update, or remove entries in the env array — see Environment variables.