Custom Domains
Set up a custom domain for a fully white-labeled experience with automated SSL.
Custom Domains
Overview
Custom domains let your clients access the platform via your own domain (e.g., app.yourdomain.com) instead of the default subdomain. This provides a fully white-labeled experience with your own branding.
Setting Up a Custom Domain
- Go to Settings → Domain & Subdomain.
- Enter your desired domain (e.g.,
app.yourdomain.com) and click Save. - Add the CNAME record shown on the page to your DNS provider.
- SSL is provisioned automatically once the CNAME is detected (usually 1–2 minutes).
- When SSL becomes active, your custom domain is live.
DNS Configuration
Add a CNAME record at your DNS provider:
- Type: CNAME
- Name/Host: the subdomain part of your domain (e.g.,
app) - Value/Target: the hostname shown in the settings page
DNS changes can take up to 24 hours to propagate, though most providers update within minutes.
Cloudflare DNS Users
If your domain’s DNS is managed by Cloudflare, you must ensure the following to avoid redirect loops:
- SSL/TLS mode must be set to “Full” (not “Flexible” or “Full (Strict)”) in your Cloudflare dashboard under SSL/TLS → Overview. Flexible mode causes an infinite redirect loop, and Full (Strict) causes SSL handshake errors.
- The CNAME record can be either proxied (orange cloud) or DNS-only (gray cloud).
- If you have “Always Use HTTPS” enabled, make sure SSL mode is “Full” — the combination of “Always Use HTTPS” with “Flexible” SSL will cause redirect loops.
SSL Certificate
SSL certificates are provisioned automatically. The status progresses through these stages:
- Waiting for CNAME — the CNAME record has not been detected yet
- Provisioning SSL — the certificate is being issued (usually 1–2 minutes)
- SSL Active — the certificate is live and your domain is secured with HTTPS
- SSL Failed — provisioning failed; verify your CNAME record and try again
The settings page automatically polls for SSL status updates every 15 seconds.
Removing a Custom Domain
Click Remove Domain to disconnect your custom domain. Your application will revert to the default subdomain URL. Any bookmarks or links to the custom domain will stop working.
Troubleshooting
- ERR_TOO_MANY_REDIRECTS — Your DNS provider’s SSL mode is likely set to “Flexible”. Change it to “Full”. This is the most common issue for Cloudflare DNS users.
- SSL stuck in “Waiting for CNAME” — Verify your CNAME record is correct:
dig +short CNAME app.yourdomain.com - Domain not loading — DNS changes can take up to 24 hours. Try clearing your browser cache and cookies.
Was this article helpful?