On the app's Domain names page, add A domain you own, create the three DNS records shown at your DNS provider, and register the domain with the ICP HTTP gateway; its certificate follows within minutes.
- Open the app, click its Domain names tile, then Add domain name.
- Pick A domain you own, type it (like app.example.com) and click Continue.
- Add these records at your DNS provider: a CNAME for the domain, a TXT record for
_canister-id.plus your domain holding the app's canister id, and a CNAME for_acme-challenge.plus your domain. Copy each host and value from the table. - If the steps include Update your app's canister, list the domain in
/.well-known/ic-domainsin your frontend's static folder (public/ or static/) and redeploy it. Where the engine lists the domain in the app's files for you, this step isn't shown. - Register the domain: run the two commands shown. The first registers it with the gateway, the second shows its status; the certificate is ready when the status is
registered. - Click Done.
Good to know
- DNS changes usually show within minutes; a record you replace can take up to its old TTL. The certificate can take a few more minutes once DNS resolves.
- On Cloudflare, keep the records DNS-only and turn off Universal SSL.
- A root domain (example.com) needs your provider's ALIAS or ANAME record, or a CNAME it flattens. GoDaddy has none of these: use a www. name instead.
- Copy agent prompt under Or hand it to your agent has your coding agent do steps 4 and 5; you add the DNS records yourself.
- Domains the engine holds for the app are listed under Custom domains, where owners and admins can Remove them; then delete the DNS records and remove the domain from the gateway too. A domain set up through the app's own file isn't tracked in the console.
- Owners and admins can always add one. Developers get Add domain name only on apps whose files the engine doesn't write.
- People who sign in at the new domain get new Internet Identity accounts unless the app keeps its canister address as its derivation origin and lists the domain in its alternative origins.