Set a custom domain for the site

Usage

stencila site domain set [OPTIONS] <DOMAIN>

Examples

# Set custom domain for the current workspace's site
stencila site domain set example.com

# Set custom domain for another workspace's site
stencila site domain set example.com --path /path/to/workspace

Arguments

Name	Description
`<DOMAIN>`	The custom domain to use for the site.

Options

Name	Description
`-p, --path`	Path to the workspace directory containing .stencila/site.yaml.

Setup Process

After running this command, you'll need to complete the following steps:

Add the CNAME record to your DNS The command will provide the exact record details (name and target)

Wait for DNS propagation (usually 5-30 minutes) DNS changes can take time to propagate globally

Check status: stencila site domain status Monitor the verification and SSL provisioning progress

Once the CNAME is detected, SSL will be provisioned automatically and your site will go live.

Troubleshooting

Domain status stuck on "Waiting for CNAME record to be configured":

Verify CNAME is configured correctly: dig example.com CNAME nslookup -type=CNAME example.com Should show your domain pointing to the CNAME target provided

Cloudflare DNS users:

Ensure CNAME is set to "DNS only" (gray cloud), NOT "Proxied" (orange cloud)

Proxied mode prevents domain verification and SSL provisioning

This setting must remain "DNS only" permanently, not just during setup

Check for conflicting DNS records:

Remove any A or AAAA records for the same hostname

Ensure no NS records delegating to a different DNS provider

Wait for DNS propagation:

DNS changes typically take 5-30 minutes (sometimes up to 48 hours)

Check propagation: https://dnschecker.org

Apex domain issues:

Some DNS providers don't support CNAME on apex/root domains

Consider using a subdomain (e.g., www.example.com) instead