deku.toml

deku.toml is the project-level configuration file used during builds and deploys.

Example

[build]
builder = "dockerfile"
dockerfile = "Dockerfile"
context = "."

[build.args]
NODE_ENV = "production"

[deploy]
healthcheck = "/health"
port = 3000
wait = 5
timeout = 30
attempts = 5
retire = 60

[processes]
web = 1
worker = 2

Build

• builder: dockerfile | nixpacks | pack | image | auto
• dockerfile: Override Dockerfile path
• context: Build context directory
• build.args: Build-time environment passed to the builder

Deploy

• healthcheck: HTTP path used during rollout validation
• port: Override the auto-detected web container port
• wait: Seconds to wait before health checks start
• timeout: Per-attempt health-check timeout
• attempts: Number of health-check retries
• retire: Seconds before old containers are retired

These settings are applied by the live deploy pipeline in dekud, not just documented metadata.

Processes

The [processes] table controls desired process counts by Procfile type.

Example:

[processes]
web = 2
worker = 1