Set up a custom domain¶

Point your own domain to a Caution deployment.

Overview¶

Caution allows you to point your own domain to your deployment. This involves two steps:

1. Configure the domain in your caution.hcl
2. Create a DNS A record pointing to your deployment's IP address

Step 1: Configure your caution.hcl¶

Set domain in the http block, fronting the port your app listens on:

network {
  ingress {
    cidr_ipv4 = "0.0.0.0/0"
    port      = 8080
  }
  http {
    domain = "api.yourdomain.com"
    port   = 8080
  }
}

Step 2: Get your deployment IP¶

After deploying your application, retrieve the IP address using either method:

Using the CLI¶

# From your app directory (uses .caution/deployment)
caution apps get

# Or specify an app ID directly
caution apps get <app-id>

The output includes your deployment's IP address.

Using the UI¶

Navigate to your application in the Caution dashboard. The deployment IP is displayed in the application details.

Step 3: Create DNS A record¶

At your DNS provider, create an A record:

For a root domain:

DNS propagation typically takes a few minutes to a few hours depending on your provider and TTL settings.

Notes¶

• TLS certificates are automatically provisioned for your custom domain
• Only one domain per deployment is currently supported
• The domain must be configured before deployment for TLS to work correctly