Documentation

Custom Domains

Set up a custom domain with free SSL for your OrbitKit-hosted pages.

Every plan includes custom domain support with a free SSL certificate. In addition to sites.orbitkit.io/your-slug, your pages can also be served at privacy.yourapp.com (or any domain you own).

Both URLs work simultaneously. Adding a custom domain does not disable your slug-based URL. Existing links to sites.orbitkit.io/your-slug will continue to work — nothing breaks.

Custom domains are required for Universal Links, App Clips, and Passkeys — these features only work on domains you own.

Setup steps

  1. In the Dashboard, go to Custom Domain and enter your domain (e.g., privacy.myapp.com).
  2. OrbitKit will show you DNS records to add. For subdomains, add a CNAME record pointing to orbitkit.io. For apex domains, add A records.
  3. After adding the DNS records, click Check Status to verify propagation.
  4. SSL is automatically provisioned via Let’s Encrypt once DNS is verified.

DNS provider examples

Cloudflare

  1. Go to your domain’s DNS settings.
  2. Add a CNAME record: Name = privacy, Target = orbitkit.io.
  3. Set the proxy status to DNS only (gray cloud). Cloudflare’s proxy is not needed since OrbitKit provides SSL and CDN.

Namecheap

  1. Go to Advanced DNS for your domain.
  2. Add a CNAME record: Host = privacy, Value = orbitkit.io., TTL = Automatic.

GoDaddy

  1. Go to DNS Management for your domain.
  2. Add a CNAME record: Name = privacy, Value = orbitkit.io, TTL = 1 Hour.

Removing a custom domain

In the Dashboard, click Remove Domain in the Custom Domain section. This immediately removes the domain mapping. Your slug-based URL continues to work.

After removing, you should also delete the DNS records from your DNS provider.

Troubleshooting

DNS not propagating

DNS changes can take up to 48 hours to propagate, but typically complete within a few minutes. You can check propagation status using tools like dnschecker.org.

SSL certificate not provisioning

SSL provisioning starts automatically once DNS is verified. It typically takes 1–5 minutes. If it takes longer:

  • Verify your DNS records are correct and fully propagated.
  • Make sure you don’t have conflicting DNS records (e.g., an existing A record for the same subdomain).
  • If using Cloudflare, ensure the proxy is disabled (gray cloud) for this record.

“Domain in use” error

Each domain can only be mapped to one OrbitKit app. If you see this error, the domain is already mapped to another app. Remove it from the other app first.

DNS propagation DNS changes can take up to 48 hours to propagate, but typically complete within a few minutes. You can check the status from your Dashboard at any time.