Coline Docs
Sites

Custom domains

Serve a site on your own domain, with HTTPS issued and renewed for you.

Sites in a Workspace Pro workspace can use their own domains, up to five per site. The site keeps its coline.space address too.

npx coline-app domains add www.example.com

The command prints the DNS records to add at your DNS provider:

TypeNameValue
CNAMEwww.example.comcustomers.coline.space
TXTthe name it printsthe value it prints, which proves you own the domain

Then check on it:

npx coline-app domains status

A domain goes from pending to active once its DNS checks out and its certificate is issued, usually within minutes. Coline issues and renews the certificate. The console's Site settings show the same records and states and refresh pending domains on their own.

On an active domain:

  • pages, links, the canonical URL and the sitemap use the custom domain;
  • Sign in with Coline returns visitors to the custom domain;
  • visitors who signed in on the coline.space address sign in again, since sessions belong to one host.

Remove a domain with npx coline-app domains remove www.example.com or in the console. Deleting a site removes its domains.

ErrorMeans
SITE_DOMAINS_REQUIRE_PROThe workspace isn't on Workspace Pro
SITE_DOMAINS_REQUIRE_CLAIMClaim the site first
SITE_DOMAIN_TAKENAnother site already uses the domain
SITE_DOMAIN_LIMITThe site already has five domains
SITE_DOMAIN_INVALIDNot a domain you can connect, such as a coline.space address