Custom Domain Setup

# Custom domain setup

EclipsePulse - Totality plan feature.

Connect your own domain (for example `status.yourcompany.com`) to your EclipsePulse status page so customers see your branding instead of the platform hostname.

## 1. Add the CNAME at your DNS provider

At your DNS provider (Cloudflare, Route 53, Namecheap, GoDaddy, etc.) create a single CNAME record.

### Record values

``` Type: CNAME Host: status (or whatever subdomain you chose) Target: doombringerz.com TTL: Auto (or 300 / 3600) ```

> Most providers expect the **Host** field to contain only the subdomain portion (e.g. `status`), not the full domain. The system automatically appends your zone (`yourcompany.com`) to it.

## 2. Save the domain in EclipsePulse

1. Open **Page Settings** in your dashboard. 2. Scroll to the **Custom domain** card. 3. Enter the full hostname (e.g. `status.yourcompany.com`). 4. Click **Save settings**.

## 3. Verify

Open `https://status.yourcompany.com` in a browser. You should see your status page rendered directly under your own domain. If you see the platform homepage instead, DNS propagation may still be in progress. Wait 5 to 30 minutes and retry.

### Quick CLI check

``` dig status.yourcompany.com CNAME +short # expected: doombringerz.com. ```

## HTTPS / TLS

The platform terminates TLS for custom domains automatically. Nothing to configure on your end. Once DNS resolves to our edge, the certificate is issued the first time a request comes in for your domain.

> If you used Cloudflare's "Proxied" (orange cloud) mode, switch the record to **DNS-only** (grey cloud). Proxied mode causes a redirect loop because both Cloudflare and our edge try to terminate TLS.

## Common pitfalls

- **Apex / root domain not supported.** Use a subdomain (`status.`, `health.`, etc.). CNAMEs cannot point a bare apex domain. - **Domain already taken.** Each custom domain can only attach to one status page across the platform. If you see "domain is already attached to another status page" you may have an old page on a different account holding the domain. - **Plan downgrade.** Custom domains require Totality. If you downgrade, the domain stays saved but stops resolving. Visitors fall through to the platform homepage until you re-upgrade.

## Removing a custom domain

Clear the field in **Page Settings > Custom domain** and save. Visitors hitting your old hostname will fall through normally. You can also remove the CNAME at your DNS provider for a clean cut.