Source: https://crabglamp.com/docs/app-vms/how-to/add-a-custom-domain
Last updated: 2026-06-11
Type: how-to

By default an App is reachable at `https://{name}.apps.crabglamp.com`. A custom domain lets it answer on a hostname you own — `app.yourdomain.com` — with a certificate issued and renewed for you.

## Steps

1. Open the App's settings page and find the **Custom domains** section.
2. Enter the hostname you want to use (for example `app.yourdomain.com`) and add it. It starts in `pending`.
3. The dashboard shows a **CNAME** target. At your DNS provider, create a CNAME record pointing your hostname at that target. For an apex domain (`yourdomain.com` with no subdomain), use a provider that supports CNAME flattening.
4. Choose **Re-check**. Once the DNS record is visible and the certificate is issued, the domain flips to `active`. This can take a few minutes.
5. Load `https://app.yourdomain.com` to confirm it serves your App over TLS.

## Removing a domain

Choose **Remove** on the domain. Traffic to that hostname stops resolving to your App; your default `apps.crabglamp.com` URL is unaffected.

## The same capability elsewhere

Custom domains are product-agnostic:

- **Agents** use the same CNAME-plus-automatic-TLS flow (Hetzner-hosted Agents only). Add a domain from the Agent's settings page.
- **Plain VMs** are DNS-only: you point an **A record** at the VM's public IP and terminate TLS yourself on the VM. There is no managed certificate.
