Workspace Setup
Custom domain: Troubleshooting
Diagnose and fix common issues with custom domain setup: pending DNS, SSL issuance, and provider-specific quirks.
If your custom domain is stuck in a pending state, the portal is not loading over HTTPS, or your domain stopped working unexpectedly, use this guide to diagnose the most common causes and fixes. For initial setup steps, see Setting up a custom domain for your portal.
Quick reference: setup stages
Your custom domain moves through three stages after you add your DNS records:
| Stage | What's happening | Typical duration |
|---|---|---|
| Pending DNS | Atomicwork is waiting for your DNS records to be detected. | 1-5 minutes, occasionally up to 30 minutes |
| Pending SSL | DNS is verified and Atomicwork is issuing your SSL certificate. | A few minutes |
| Connected | Your custom domain is live and secured with HTTPS. | No action needed |