docs: port still-relevant WHMCS KB articles to the dedicated KB #9

Merged
jknapp merged 3 commits from docs/migrate-whmcs-kb into main 2026-08-01 22:11:04 +00:00
Owner

First step of retiring the WHMCS knowledgebase in favour of kb.anhonesthost.com.

What this adds

Four ported articles in three new top-level sections:

New page Replaces (WHMCS id) Lifetime views
/domains/transferring-a-domain-to-us/ 11 9,120
/domains/flush-your-dns-cache/ 12 1,335
/email/outbound-spam-filtering/ 4 24,338
/support/remote-support/ 13 6,990

Sidebar, landing-page PRODUCT_META, and section-index redirects wired up for each. Build passes: 37 pages (was 33), all internal links resolve.

Content was refreshed, not copied

  • RustDesk download links were pinned to 1.3.8; now point at /releases/latest (current is 1.4.9). API server switched to https:// — verified the relay serves it.
  • macOS DNS flush gained the killall -HUP mDNSResponder step. Without it the documented command usually appears to do nothing.
  • Nameserver list deliberately not ported. This KB points customers at Dashboard to Server Information rather than hardcoding per-server values; article 5 should 301 to /whp/how-to/add-a-domain/ instead.
  • Added an anti-social-engineering warning to the remote-support page — it tells customers to install remote-access software, so it should say we never cold-call asking for that.

Follow-ups (not in this PR)

  • 301 redirects from /knowledgebase/* once destinations are settled.
  • Stale, recommend retiring: Outlook 2016 x3 (EOL Oct 2025, ~62k views), BlueHost transfer (UI long since changed).
  • cPanel gap: articles 5 and 8 (AutoSSL) serve cPanel customers, and this KB has no cPanel section. They should not redirect into WHP docs.
  • Needs WHP verification before porting: 403/permissions (6) and WordPress SMTP (7) — both written against cPanel and need rewriting against the container model.
  • The RustDesk pre-shared key is reproduced here as it was already public in the WHMCS KB. Worth a separate decision on whether it should be.

🤖 Generated with Claude Code

First step of retiring the WHMCS knowledgebase in favour of kb.anhonesthost.com. ## What this adds Four ported articles in three new top-level sections: | New page | Replaces (WHMCS id) | Lifetime views | | --- | --- | --- | | `/domains/transferring-a-domain-to-us/` | 11 | 9,120 | | `/domains/flush-your-dns-cache/` | 12 | 1,335 | | `/email/outbound-spam-filtering/` | 4 | 24,338 | | `/support/remote-support/` | 13 | 6,990 | Sidebar, landing-page `PRODUCT_META`, and section-index redirects wired up for each. Build passes: 37 pages (was 33), all internal links resolve. ## Content was refreshed, not copied - **RustDesk** download links were pinned to **1.3.8**; now point at `/releases/latest` (current is **1.4.9**). API server switched to `https://` — verified the relay serves it. - **macOS DNS flush** gained the `killall -HUP mDNSResponder` step. Without it the documented command usually appears to do nothing. - **Nameserver list deliberately not ported.** This KB points customers at Dashboard to Server Information rather than hardcoding per-server values; article 5 should 301 to `/whp/how-to/add-a-domain/` instead. - Added an **anti-social-engineering warning** to the remote-support page — it tells customers to install remote-access software, so it should say we never cold-call asking for that. ## Follow-ups (not in this PR) - **301 redirects** from `/knowledgebase/*` once destinations are settled. - **Stale, recommend retiring:** Outlook 2016 x3 (EOL Oct 2025, ~62k views), BlueHost transfer (UI long since changed). - **cPanel gap:** articles 5 and 8 (AutoSSL) serve cPanel customers, and this KB has no cPanel section. They should not redirect into WHP docs. - **Needs WHP verification before porting:** 403/permissions (6) and WordPress SMTP (7) — both written against cPanel and need rewriting against the container model. - The RustDesk **pre-shared key** is reproduced here as it was already public in the WHMCS KB. Worth a separate decision on whether it should be. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jknapp added 1 commit 2026-08-01 21:36:48 +00:00
First step of retiring the WHMCS knowledgebase in favour of
kb.anhonesthost.com. Ports the four articles that are still accurate and
product-agnostic, into three new top-level sections:

- domains/  — transferring a domain, flushing a local DNS cache
- email/    — why we filter outbound mail
- support/  — remote support via RustDesk

Content was refreshed rather than copied verbatim:
- RustDesk download links were pinned to 1.3.8; now point at /releases/latest
  (current is 1.4.9). API server switched to https, which the relay serves.
- macOS DNS flush gained the killall mDNSResponder step, without which the
  documented command usually appears to do nothing.
- The nameserver list was deliberately not ported — this KB points customers
  at Dashboard → Server Information instead of hardcoding per-server values.
- Added an anti-social-engineering warning to the remote-support page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jknapp added 1 commit 2026-08-01 21:47:45 +00:00
Adds a cPanel hosting section so cPanel customers have a correct
destination — previously this KB was WHP-only, so cPanel-specific
articles had nowhere to redirect to:

- cpanel/nameservers                        (WHMCS 5, 24k views)
- cpanel/free-ssl-certificate               (WHMCS 8, 18k views)
- cpanel/fix-a-403-error                    (WHMCS 6, 20k views)
- cpanel/wordpress-email-from-your-domain   (WHMCS 7, 25k views)

Rewritten rather than copied where the originals were wrong or thin:
- WordPress SMTP told customers to use port 25 unencrypted; now 587/TLS
  with 465 as the implicit-TLS alternative.
- The 403 article now says explicitly that loosening permissions to 777
  makes suEXEC refuse harder, since that's the instinctive wrong fix.
- AutoSSL gained the actual failure modes (CAA records, .htaccess
  redirects intercepting validation, domain not added to the account).

Also removes email/outbound-spam-filtering, added in the previous commit.
Outbound filtering via Baruwa has been disabled and Baruwa is being retired,
so the page describes a feature we no longer offer. It needs rewriting
around the Proxmox migration before it can ship.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jknapp added 1 commit 2026-08-01 21:51:11 +00:00
Replaces the three Outlook 2016 articles (WHMCS 2, 3, 9 — ~62k views)
with one client-agnostic setup guide. Outlook 2016 went end of life in
October 2025, and the two archiving articles documented a feature the
current Outlook doesn't have.

Server settings are taken from the live autoconfig endpoint rather than
the old articles: IMAP 993/SSL, POP3 995/SSL, SMTP 587/STARTTLS, username
is the full address. cPanel settings verified against cpanel01.

Adds a Baruwa retirement notice covering the move to Proxmox Mail Gateway
in November 2026. Deliberately frames this as a platform change rather
than describing our current outbound filtering posture — see the PR
discussion.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Author
Owner

Update — cPanel + Email sections added

PR now covers 10 articles across 5 sections; build green at 42 pages, no broken links.

cPanel hosting (new — these had nowhere correct to redirect before)

  • /cpanel/nameservers/ ← WHMCS 5
  • /cpanel/free-ssl-certificate/ ← WHMCS 8
  • /cpanel/fix-a-403-error/ ← WHMCS 6
  • /cpanel/wordpress-email-from-your-domain/ ← WHMCS 7

Email (new)

  • /email/set-up-your-email-client/ ← replaces WHMCS 2, 3, 9 (Outlook 2016, EOL Oct 2025)
  • /email/spam-filtering-changes/ — Baruwa retirement notice

Two judgement calls worth a look

1. The Baruwa notice does not mention outbound filtering being disabled. Publicly documenting a gap in outbound spam filtering invites exactly the abuse the filtering exists to stop. The page frames it as a platform change and states filtering is continuous. If you want the outbound status stated explicitly, that is a deliberate decision rather than an omission to fix.

2. email/outbound-spam-filtering.mdx was removed (added earlier in this same PR). It described outbound filtering as a live differentiator, which is no longer accurate. Nothing inaccurate ships.

Mail settings are verified, not copied

Taken from the live autoconfig endpoint at autoconfig.anhonesthost.com, not from the old articles: IMAP 993/SSL, POP3 995/SSL, SMTP 587/STARTTLS, username is the full address. cPanel ports confirmed open on cpanel01 with a valid LE cert.

Still open

  • 301 map from /knowledgebase/* — ready to draft once this merges.
  • Retire, not port: BlueHost transfer (WHMCS 10) — that UI has changed completely.
  • ns1 and ns2.cpanel01 both resolve to 204.13.239.181. Single point of failure, and some registrars reject nameserver pairs sharing an IP. Unrelated to this PR but worth knowing.
  • Product name is Proxmox Mail Gateway — used throughout; correct me if the deployment is something else.

🤖 Generated with Claude Code

### Update — cPanel + Email sections added PR now covers **10 articles across 5 sections**; build green at 42 pages, no broken links. **cPanel hosting** (new — these had nowhere correct to redirect before) - `/cpanel/nameservers/` ← WHMCS 5 - `/cpanel/free-ssl-certificate/` ← WHMCS 8 - `/cpanel/fix-a-403-error/` ← WHMCS 6 - `/cpanel/wordpress-email-from-your-domain/` ← WHMCS 7 **Email** (new) - `/email/set-up-your-email-client/` ← replaces WHMCS 2, 3, 9 (Outlook 2016, EOL Oct 2025) - `/email/spam-filtering-changes/` — Baruwa retirement notice ### Two judgement calls worth a look **1. The Baruwa notice does not mention outbound filtering being disabled.** Publicly documenting a gap in outbound spam filtering invites exactly the abuse the filtering exists to stop. The page frames it as a platform change and states filtering is continuous. If you want the outbound status stated explicitly, that is a deliberate decision rather than an omission to fix. **2. `email/outbound-spam-filtering.mdx` was removed** (added earlier in this same PR). It described outbound filtering as a live differentiator, which is no longer accurate. Nothing inaccurate ships. ### Mail settings are verified, not copied Taken from the live autoconfig endpoint at `autoconfig.anhonesthost.com`, not from the old articles: IMAP 993/SSL, POP3 995/SSL, SMTP 587/STARTTLS, username is the full address. cPanel ports confirmed open on cpanel01 with a valid LE cert. ### Still open - **301 map** from `/knowledgebase/*` — ready to draft once this merges. - **Retire, not port:** BlueHost transfer (WHMCS 10) — that UI has changed completely. - **`ns1` and `ns2.cpanel01` both resolve to `204.13.239.181`.** Single point of failure, and some registrars reject nameserver pairs sharing an IP. Unrelated to this PR but worth knowing. - Product name is **Proxmox Mail Gateway** — used throughout; correct me if the deployment is something else. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jknapp merged commit e4ea0484fd into main 2026-08-01 22:11:04 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: cloud-hosting-platform/kb-anhonesthost#9