Files
kb-anhonesthost/src/content/docs/whp/how-to/add-a-domain.mdx
T
shadowdao c602b8f8f3 docs: verify against real WHP + capture real screenshots
Discovery against the demo account on whp01 surfaced several inaccuracies:

- Cache is Valkey (Redis wire-compatible), not Redis or Memcached.
  No Memcached is offered as a separate service.
- Site Monitoring is the sidebar label (not 'AI Monitor').
- 'Add a domain' has no Primary/Add-on distinction.
- Sites form: 'Container Type' (not 'Site type'), Number of Containers
  (1-10 for horizontal scaling), CPU per Container (default 0.25),
  Memory per Container (default 256MB), SSL inline on the same form.
- Backups: default retention 5 days / 10 backups; on-demand + scheduled;
  S3 backup targets are visible and configurable.
- Email: per-domain settings live behind 'Setup Instructions' on the
  Email page; mail server hostname is on the Dashboard (per-server,
  e.g. mail01.cloud-hosting.io), not per-domain.

Also reworked the screenshot pipeline:
- New shots.config.ts targets the real index.php?page=... URLs
- Added redactSensitive() step that runs before each screenshot to swap
  server names, IPs, mail hostnames, and demo-user-isms with neutral
  placeholders. This keeps docs portable across the fleet.
- Hides .brand-full and .navbar-text (top-bar server identifier and
  Welcome greeting).
- Captured 9 real WHP screenshots; removed stale placeholders.
2026-05-17 17:00:13 -07:00

84 lines
3.2 KiB
Plaintext

---
title: Add a domain
description: Point a domain at your WHP hosting — whether you registered it with us or elsewhere.
sidebar:
order: 1
---
import { Steps, Aside } from '@astrojs/starlight/components';
import SignIn from '~/content/partials/signing-in.mdx';
import Support from '~/content/partials/support-link.mdx';
## Before you start
- A **registered domain.** We sell domains through Namecheap, and you can also register with any other provider you like.
- **Access to the registrar's DNS settings** if you registered the domain elsewhere.
- About 5 minutes (plus DNS propagation time, which can be up to 24 hours).
<Aside type="tip">
If you registered your domain with us, we can help with DNS, redirects, and email records directly. If you registered elsewhere, we can still help — you'll just need to make the actual changes at your registrar.
</Aside>
## Sign in to WHP
<SignIn />
## Steps
<Steps>
1. In the sidebar, click **Domains**.
![WHP Domains page](~/assets/screenshots/whp/whp-domains.png)
2. Under **Add New Domain** on the left, type your domain (for example, `example.com`). Don't include `http://` or `www.` — just the bare domain.
3. Click **Add Domain**.
</Steps>
WHP creates the standard set of DNS records automatically for the new domain:
- **A record** for the apex domain → your server's IP
- **CNAME** for `www` → the apex
- **NS records** for the nameservers
- **MX record** → the mail server
- **TXT record** for SPF
You can review and tweak any of these from the **DNS Management** panel on the right side of the Domains page (select the domain from the dropdown).
## Point your DNS at us
There are two paths depending on where the domain is registered:
**Registered with us.** Nothing to do — we set DNS automatically when the domain was added. Skip ahead to verify.
**Registered elsewhere.** At your registrar, do one of the following:
- Set the **nameservers** to the values shown on the Domains page (recommended — gives us full DNS control, easier to support), **or**
- Keep your existing nameservers and add an **A record** pointing the domain to the IP shown on the **Dashboard** page under Server Information.
## Verify it worked
DNS changes can take up to 24 hours to propagate worldwide. To check:
- Run `dig example.com +short` from a terminal — once you see our server's IP in the result, you're live.
- Or use a web tool like [whatsmydns.net](https://www.whatsmydns.net/) to see propagation across many regions.
Once DNS resolves, visiting your domain in a browser will reach WHP — though you'll see a default placeholder until you create a site.
## Troubleshooting
**"Pending DNS" for more than 24 hours.** Re-check the nameservers or A record at your registrar — typos and trailing dots cause silent failures. Clear your local DNS cache to rule out client-side caching.
**Domain returns a generic placeholder.** DNS works but you haven't created a site yet. [Create one](/whp/how-to/create-a-site/) and bind this domain to it.
**Wrong site loads.** Another site on your account is bound to this domain. Open **Sites** in the sidebar and make sure the correct site is bound to it.
## Related
- [Create a site](/whp/how-to/create-a-site/)
## Still stuck?
<Support />