MultiTool configuration reference
MultiTool uses a hierarchical TOML file to configure deployments, ingress, and observability. This reference describes all supported fields and their relationships, including CLI and environment variable overrides.
[config.cloudflare] is mutually exclusive with [config.platform], [config.ingress], and [config.monitor].
Top-level fields
workspace
- Type:
string - Required: optional
- Description: Name for the MultiTool workspace to which this project belongs.
- Source: CLI flag
--workspace, env varMULTI_WORKSPACE - Example:
workspace = "acme-corp"
application
- Type:
string - Required: optional
- Description: Name of the application being deployed.
- Source: CLI flag
--application, env varMULTI_APPLICATION - Example:
application = "billing-api"
[config.cloudflare] (Cloudflare)
Defines how MultiTool deploys and observes your app using Cloudflare Workers.
Supported fields
An API token is required and must be provided outside this file via --cloudflare-api-token or CLOUDFLARE_API_TOKEN.
| Field | Type | Required | Description |
|---|---|---|---|
wrangler | boolean | ✅ Yes | Whether to use wrangler.toml to infer Worker name and account ID. |
account_id | string | ❌ No | The Cloudflare account ID to use when deploying to Workers. Required at runtime. May be provided via --cloudflare-account-id, CLOUDFLARE_ACCOUNT_ID, or inferred from wrangler.toml. Optional in the config file. |
worker_name | string | ❌ No | The name of the Cloudflare Worker to deploy. Required at runtime. May be provided via --cloudflare-worker-name, CLOUDFLARE_WORKER_NAME, or inferred from wrangler.toml. Optional in the config file. |
Example
workspace = "acme-corp"
application = "billing-api"
[config.cloudflare]
wrangler = true
account_id = "abcdef1234567890"
worker_name = "billing-api-worker"
[config.platform] (AWS)
Defines how MultiTool deploys and observes your app using AWS Lambda.
Supported fields
[config.platform.aws-lambda]
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ Yes | Lambda function name. |
region | string | ✅ Yes | The AWS region to deploy into. May also be set via --aws-region or AWS_REGION. |
Example
[config.platform.aws-lambda]
name = "auth-service"
region = "us-west-2"
[config.ingress] (AWS ingress)
Defines the HTTP ingress to reach your deployed application on AWS.
Supported fields
[config.ingress.aws-api-gateway]
| Field | Type | Required | Description |
|---|---|---|---|
stage-name | string | ✅ Yes | Gateway stage name |
gateway-name | string | ✅ Yes | API Gateway name |
resource-path | string | ✅ Yes | Route path (e.g. /login) |
resource-method | string | ✅ Yes | HTTP method (e.g. POST) |
region | string | ✅ Yes | AWS region (same as in platform) |
Example
[config.ingress.aws-api-gateway]
stage-name = "dev"
gateway-name = "example-gateway"
resource-path = "/example"
resource-method = "POST"
region = "us-west-2"
config.monitor (Observability)
MultiTool supports monitoring integrations that report the status of your deployments. You may enable one observability provider depending on your target platform.
For AWS:
Use [config.monitor.aws-cloudwatch] to enable CloudWatch metrics collection.
- Description: Enables AWS CloudWatch monitoring.
- Fields: None (presence enables integration)
[config.monitor.aws-cloudwatch]
For Cloudflare:
Use [config.monitor.cloudflare-observability] to integrate with Cloudflare's observability platform.
- Description: Enables Cloudflare Observability integration.
- Fields: None (presence enables integration)
[config.monitor.cloudflare-observability]
Resolution priority
For each value, MultiTool resolves configuration in the following order:
- CLI flag
- Environment variable
TOMLconfig file (multitool.toml)- Wrangler fallback (if
wrangler = true)
Related CLI flags
These flags override config file values:
| CLI Flag | Affects Field | Description |
|---|---|---|
--workspace | workspace | Workspace group name |
--application | application | Application name |
--origin | origin | Deployment origin (used internally) |
--cloudflare-account-id | account_id | Cloudflare account ID |
--cloudflare-worker-name | worker_name | Cloudflare Worker name |
--cloudflare-api-token | (not in config) | Required to deploy to Cloudflare |
--aws-region | region | AWS region for Lambda/API Gateway |