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.
84 lines
3.2 KiB
Plaintext
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**.
|
|

|
|
|
|
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 />
|