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 Procfile
2. Create a DNS A record pointing to your deployment's IP address

Step 1: Configure your Procfile¶

Add the domain field to your Procfile:

domain: api.yourdomain.com

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