# Custom domains

> Point your own domain at a service and get automatic HTTPS.

Source: https://gheima.ma/docs/custom-domains

Point a domain you own at a service and Gheima provisions HTTPS for it automatically. Domains are added per service and counted across your account.

1. Add the domain — Gheima returns the DNS records to create.
2. DNS records — A CNAME and a TXT challenge at your provider.
3. Verify — Gheima checks the TXT record.
4. HTTPS — Certificates are issued and renewed for you.

### Add a domain

1. **Open Custom domains** — On the service page, find the Custom domains panel and click “Add domain”.
2. **Enter your domain** — Type a domain you own, e.g. app.example.com, and confirm. Gheima gives you the DNS records to add.

### Add the DNS records

At your DNS provider, create these records, then come back and click "Verify":

- `CNAME`: Name: your domain. Value: your service’s subdomain, e.g. my-app.gheima.ma.
- `TXT`: Name: _gheima-challenge.your-domain. Value: the verification token shown in the panel.

> Note: DNS can take a few minutes to propagate. If verification fails, check the TXT value, wait, and try again. If the panel also shows an A record, use it instead of the CNAME for a root domain such as example.com, which can't take a CNAME.

### Automatic TLS

Once the domain shows "Verified", we issue its HTTPS certificate and renew it automatically. There's nothing to install. Custom domains are included on the Dev, Pro, Team, and Agency plans.

> Result: Your app is reachable on your own domain over HTTPS, with certificates issued and renewed for you.

---

All docs: https://gheima.ma/docs.md
