Custom domains

Serve a site on your own domain — add it in the edit UI or via the API, point DNS at the server, and the certificate is issued automatically.

Custom domains are an Enterprise feature. In the community edition the domain API returns 403.

Add a domain

Add the domain on the site's edit page (or with the API calls below), then point DNS at your server:

RecordNameValue
Ayour domainyour server IP
CNAMEyour domainyour base domain, e.g. sitebin.example.com

One record is enough — either the A record or the CNAME.

Certificates

The certificate is issued automatically on the first HTTPS request — there is nothing to configure per domain. An internal tls-check endpoint ensures certificates are only issued for domains that actually belong to a site, which prevents strangers from triggering certificate issuance for arbitrary hostnames (issuance-DoS).

Limits

Per-account limits follow the tier's custom_domains cap. On the hosted service the cap comes from your plan.

API

# add a custom domain (Enterprise edition only; 403 in community)
curl -X POST -H "X-Edit-Password: $PW" -H "Content-Type: application/json" \
     -d '{"domain":"docs.client.com"}' \
     https://sitebin.example.com/api/sites/$EDIT_ID/domains

# remove it
curl -X DELETE -H "X-Edit-Password: $PW" \
     https://sitebin.example.com/api/sites/$EDIT_ID/domains/docs.client.com