Compare commits
5
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 jknapp
|
0e3ae941eb | ||
  AnHonestHost DevandClaude Opus 5
|
1e3e0bd546 | ||
|
jknapp
|
a28e20f881 | ||
|
AnHonestHost DevandClaude Opus 5
|
063f992516 | ||
|
jknapp
|
e4ea0484fd |
@@ -0,0 +1,59 @@
|
||||
# Deploy artefacts
|
||||
|
||||
Config that lives on other servers but belongs under version control here,
|
||||
because it exists to serve this KB.
|
||||
|
||||
## `whmcs-kb-redirects.conf`
|
||||
|
||||
301 redirects that send the retired WHMCS knowledgebase
|
||||
(`secure.anhonesthost.com/knowledgebase/*`) to its replacement pages on
|
||||
kb.anhonesthost.com. Installed 2026-08-01.
|
||||
|
||||
**Where it lives in production:** `/home/whmcs/public_html/.htaccess` on
|
||||
`secure.anhonesthost.com`, prepended **before** the
|
||||
`### BEGIN - WHMCS managed rules ###` marker. It has to come first — WHMCS's
|
||||
own block ends with a catch-all that routes everything to `index.php`, so
|
||||
rules placed after it never run.
|
||||
|
||||
The canonical copy on that server is `/root/kb-redirects.conf`, and the
|
||||
pre-migration `.htaccess` is backed up at
|
||||
`/root/htaccess-backup-20260801.bak`.
|
||||
|
||||
### Reinstalling
|
||||
|
||||
WHMCS rewrites `.htaccess` during some updates, which will silently drop
|
||||
these rules. To restore:
|
||||
|
||||
```bash
|
||||
cd /home/whmcs/public_html
|
||||
cp -a .htaccess /root/htaccess-backup-$(date +%Y%m%d).bak # keep whatever WHMCS wrote
|
||||
cat /root/kb-redirects.conf /root/htaccess-backup-$(date +%Y%m%d).bak > /tmp/htaccess.new
|
||||
install -o whmcs -g whmcs -m 644 /tmp/htaccess.new .htaccess
|
||||
apachectl -t
|
||||
```
|
||||
|
||||
Then spot-check a redirect:
|
||||
|
||||
```bash
|
||||
curl -sI https://secure.anhonesthost.com/knowledgebase/13/x.html | grep -i location
|
||||
# expect: https://kb.anhonesthost.com/support/remote-support/
|
||||
```
|
||||
|
||||
### Two things that will bite you when editing it
|
||||
|
||||
**Article and category IDs collide.** Both use the shape
|
||||
`/knowledgebase/<id>/<slug>`, and the same number means different things —
|
||||
article 5 is "What are my Name Servers?", category 5 is "WordPress Specific".
|
||||
The *only* discriminator is the trailing `.html` on articles. That's why every
|
||||
article rule appears before every category rule and terminates with `[L]`: by
|
||||
the time the broad category patterns run, anything ending `.html` is already
|
||||
gone. Reordering the file breaks this silently, and the wrong page still
|
||||
returns 200.
|
||||
|
||||
**The slug is ignored.** WHMCS reads only the id, so any slug with the right
|
||||
id resolves. The rules match `[^/]*` for the slug for the same reason.
|
||||
|
||||
Legacy pre-SEO URLs (`knowledgebase.php?action=displayarticle&id=N` and
|
||||
`?action=displaycat&catid=N`) are mapped explicitly. `(^|&)id=` cannot match
|
||||
`catid=` — the preceding character is `t`, not `&` or start-of-string — so the
|
||||
two sets can't cross-fire.
|
||||
@@ -0,0 +1,107 @@
|
||||
### BEGIN - KB migration redirects to kb.anhonesthost.com ###
|
||||
# Added 2026-08-01. The WHMCS knowledgebase is retired; these 301s send its
|
||||
# URLs to the equivalent page on the dedicated KB.
|
||||
#
|
||||
# ORDER MATTERS. Article and category URLs share the shape
|
||||
# /knowledgebase/<id>/<slug>
|
||||
# and their IDs COLLIDE (article 5 is "What are my Name Servers?", category 5
|
||||
# is "WordPress Specific"). The only discriminator is the trailing ".html" on
|
||||
# articles. Article rules therefore come first and terminate with [L]; the
|
||||
# category rules below can then match broadly because anything ending .html
|
||||
# has already been redirected and will never reach them.
|
||||
#
|
||||
# The slug is ignored by WHMCS (only the id is read), so it is ignored here
|
||||
# too — any slug with the right id resolves to the right destination.
|
||||
#
|
||||
# The trailing "?" on each target discards the inbound query string.
|
||||
<IfModule mod_rewrite.c>
|
||||
RewriteEngine on
|
||||
RewriteBase /
|
||||
|
||||
# --- Articles (.html) -------------------------------------------------
|
||||
RewriteRule ^knowledgebase/2/[^/]*\.html$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/3/[^/]*\.html$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/4/[^/]*\.html$ https://kb.anhonesthost.com/email/spam-filtering-changes/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/5/[^/]*\.html$ https://kb.anhonesthost.com/cpanel/nameservers/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/6/[^/]*\.html$ https://kb.anhonesthost.com/cpanel/fix-a-403-error/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/7/[^/]*\.html$ https://kb.anhonesthost.com/cpanel/wordpress-email-from-your-domain/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/8/[^/]*\.html$ https://kb.anhonesthost.com/cpanel/free-ssl-certificate/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/9/[^/]*\.html$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/10/[^/]*\.html$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/11/[^/]*\.html$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/12/[^/]*\.html$ https://kb.anhonesthost.com/domains/flush-your-dns-cache/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/13/[^/]*\.html$ https://kb.anhonesthost.com/support/remote-support/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/14/[^/]*\.html$ https://kb.anhonesthost.com/whp/getting-started/welcome/? [R=301,L]
|
||||
|
||||
# --- Categories (no .html) --------------------------------------------
|
||||
RewriteRule ^knowledgebase/2/[^/]*/?$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/3/[^/]*/?$ https://kb.anhonesthost.com/email/spam-filtering-changes/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/4/[^/]*/?$ https://kb.anhonesthost.com/cpanel/nameservers/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/5/[^/]*/?$ https://kb.anhonesthost.com/cpanel/wordpress-email-from-your-domain/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/6/[^/]*/?$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/7/[^/]*/?$ https://kb.anhonesthost.com/cpanel/fix-a-403-error/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/8/[^/]*/?$ https://kb.anhonesthost.com/support/remote-support/? [R=301,L]
|
||||
RewriteRule ^knowledgebase/9/[^/]*/?$ https://kb.anhonesthost.com/whp/getting-started/welcome/? [R=301,L]
|
||||
|
||||
# --- Legacy query-string URLs -----------------------------------------
|
||||
# Pre-SEO-URL links still in old tickets and emails:
|
||||
# knowledgebase.php?action=displayarticle&id=<id>
|
||||
# knowledgebase.php?action=displaycat&catid=<id>
|
||||
# WHMCS used to 301 these to the friendly URL itself, but our rules above
|
||||
# now intercept first — so map them explicitly or they all land on the KB
|
||||
# home page and lose their destination.
|
||||
#
|
||||
# "(^|&)id=" cannot match "catid=" (the preceding char is "t", not & or
|
||||
# start-of-string), so the two sets can't cross-fire.
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=2(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=3(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=4(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/spam-filtering-changes/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=5(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/nameservers/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=6(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/fix-a-403-error/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=7(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/wordpress-email-from-your-domain/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=8(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/free-ssl-certificate/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=9(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=10(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=11(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=12(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/domains/flush-your-dns-cache/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=13(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/support/remote-support/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)id=14(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/whp/getting-started/welcome/? [R=301,L]
|
||||
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=2(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/set-up-your-email-client/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=3(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/email/spam-filtering-changes/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=4(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/nameservers/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=5(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/wordpress-email-from-your-domain/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=6(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=7(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/cpanel/fix-a-403-error/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=8(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/support/remote-support/? [R=301,L]
|
||||
RewriteCond %{QUERY_STRING} (^|&)catid=9(&|$)
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/whp/getting-started/welcome/? [R=301,L]
|
||||
|
||||
# --- Tags, search, index, and anything else under /knowledgebase ------
|
||||
# Catch-all last: any KB URL not matched above lands on the KB home page
|
||||
# rather than a WHMCS 404.
|
||||
RewriteRule ^knowledgebase\.php$ https://kb.anhonesthost.com/? [R=301,L]
|
||||
RewriteRule ^knowledgebase(/.*)?$ https://kb.anhonesthost.com/? [R=301,L]
|
||||
</IfModule>
|
||||
### END - KB migration redirects to kb.anhonesthost.com ###
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
# AnHonestHost Knowledge Base
|
||||
|
||||
> Customer documentation for WHP (AnHonestHost's containerized Web Hosting Platform), plus cPanel hosting, domains, email, and remote support.
|
||||
|
||||
WHP is AnHonestHost's containerized hosting platform, and most of this knowledge base documents it: getting started, how-to guides, the Site Builder, local development with the same container images used in production, reference material, and optional add-ons. Separate sections cover legacy cPanel hosting, domain management, email setup, and remote support. Pages in the WHP Admin section document server-wide super-admin controls, which most customers won't have access to.
|
||||
|
||||
## WHP — Getting started
|
||||
|
||||
- [Welcome to WHP](https://kb.anhonesthost.com/whp/getting-started/welcome/): Quick orientation for new customers — what WHP is and where to start.
|
||||
- [What is containerized hosting?](https://kb.anhonesthost.com/whp/getting-started/what-is-containerized-hosting/): Plain-language explainer of containerized hosting and how it compares to shared hosting and a VPS.
|
||||
|
||||
## WHP — How-to guides
|
||||
|
||||
- [Add a domain](https://kb.anhonesthost.com/whp/how-to/add-a-domain/): Point a domain at your WHP hosting — whether you registered it with us or elsewhere.
|
||||
- [Manage DNS records](https://kb.anhonesthost.com/whp/how-to/manage-dns-records/): View, add, edit, and delete DNS records for your domains using the Domains & DNS records editor in WHP.
|
||||
- [Create a site](https://kb.anhonesthost.com/whp/how-to/create-a-site/): Spin up a containerized site on a domain you've added to WHP.
|
||||
- [Create an email account](https://kb.anhonesthost.com/whp/how-to/create-an-email-account/): Add a mailbox on one of your domains and connect your email client.
|
||||
- [Backups](https://kb.anhonesthost.com/whp/how-to/backups/): Run on-demand and scheduled backups of your sites and databases, and confirm they're succeeding.
|
||||
- [Switching your site's backend](https://kb.anhonesthost.com/whp/how-to/switching-site-backend/): Change the web engine (container type) running a site — standard PHP/FPM or the premium LiteSpeed/OpenLiteSpeed tier.
|
||||
- [Clear your site's cache](https://kb.anhonesthost.com/whp/how-to/clear-your-cache/): Seeing an old version of a page after making a change? Here's how to clear cached content so your updates show up.
|
||||
|
||||
## WHP — Site Builder
|
||||
|
||||
- [Site Builder overview](https://kb.anhonesthost.com/whp/site-builder/overview/): Build a website visually inside WHP — drag-and-drop blocks, ready-made templates, draft / publish workflow.
|
||||
- [Getting started](https://kb.anhonesthost.com/whp/site-builder/getting-started/): Open Site Builder, pick a template or start from scratch, make your first edits, and publish.
|
||||
- [Blocks & pages](https://kb.anhonesthost.com/whp/site-builder/blocks-and-pages/): The Site Builder block library, plus how to add pages and edit the shared header and footer.
|
||||
- [Styling your site](https://kb.anhonesthost.com/whp/site-builder/styling/): Set colours, fonts, and link styles once with Site Design Tokens; reach for Advanced when you need finer control.
|
||||
- [Publishing & code injection](https://kb.anhonesthost.com/whp/site-builder/publishing/): Drafts vs. publish, device previews, and adding analytics, custom fonts, or global CSS via the custom head code panel.
|
||||
|
||||
## WHP — Local development
|
||||
|
||||
- [Develop locally with our containers](https://kb.anhonesthost.com/whp/local-dev/overview/): Run the same Apache/PHP and Node containers locally that we use to host your site in production.
|
||||
- [PHP + Apache locally](https://kb.anhonesthost.com/whp/local-dev/php-apache/): Run the cloud-apache-container image on your laptop for WordPress and other PHP apps.
|
||||
- [Node + Nginx locally](https://kb.anhonesthost.com/whp/local-dev/node/): Run the cloud-node-container image on your laptop for Express, custom Node apps, and PM2-managed processes.
|
||||
|
||||
## WHP — Reference
|
||||
|
||||
- [Service hostnames](https://kb.anhonesthost.com/whp/reference/service-hostnames/): Quick reference for connecting to MySQL, PostgreSQL, and Valkey from inside your container.
|
||||
|
||||
## WHP — Add-ons
|
||||
|
||||
- [Add-ons overview](https://kb.anhonesthost.com/whp/add-ons/overview/): Optional features you can layer on your hosting plan — monitoring, archival email, resource upgrades, and more.
|
||||
- [Site Monitoring](https://kb.anhonesthost.com/whp/add-ons/monitoring/): Proactive alerts for site errors, brute-force attempts, and exploit signatures.
|
||||
- [Archival email](https://kb.anhonesthost.com/whp/add-ons/archival-email/): Long-term, searchable archive of your mailbox content, separate from the live mailbox.
|
||||
- [Resource upgrades](https://kb.anhonesthost.com/whp/add-ons/resource-upgrades/): Add CPU, RAM, or disk to your container without migrating to a different plan.
|
||||
- [Email upgrades](https://kb.anhonesthost.com/whp/add-ons/email-upgrades/): Add mailboxes or bump per-mailbox storage on your plan.
|
||||
- [Optimized Webserver (OpenLiteSpeed + LSCache)](https://kb.anhonesthost.com/whp/add-ons/optimized-webserver/): Run your sites on OpenLiteSpeed with server-level full-page caching for dramatically faster page delivery — ideal for WordPress and other dynamic CMS sites.
|
||||
|
||||
## WHP — Admin
|
||||
|
||||
- [Admin overview](https://kb.anhonesthost.com/whp/admin/overview/): What WHP super admin unlocks — server-wide controls for services, mail, DNS, security, monitoring, and users.
|
||||
- [Server settings & services](https://kb.anhonesthost.com/whp/admin/server-settings/): Restart services, configure mail server, manage DNS / nameservers, HAProxy + system SSL certificates, and integration API keys.
|
||||
- [Coraza WAF rules](https://kb.anhonesthost.com/whp/admin/coraza-waf/): Set the global WAF mode, tune individual rules, audit blocked requests, and add per-host overrides.
|
||||
- [AI Monitor, Issues & Ignore Rules](https://kb.anhonesthost.com/whp/admin/site-monitoring/): The three admin pages that drive the Site Monitoring add-on — AI Monitor dashboard, Issues, and Ignore Rules.
|
||||
- [Users & delegated access](https://kb.anhonesthost.com/whp/admin/user-management/): Create WHP users, set account types, change passwords, plus delegated user access and account suspensions.
|
||||
- [Backups](https://kb.anhonesthost.com/whp/admin/backups/): How WHP's automatic backups work, the default-target requirement, full-server backups vs customer data backups, and managing backup targets.
|
||||
- [Data-drive encryption (LUKS)](https://kb.anhonesthost.com/whp/admin/data-drive-encryption/): Optional LUKS2 encryption of the /docker data volume on new server installs. Encrypts customer data, databases, and container state at rest; adds a manual unlock step after every reboot.
|
||||
|
||||
## cPanel hosting
|
||||
|
||||
- [What are my nameservers?](https://kb.anhonesthost.com/cpanel/nameservers/): The nameservers to set at your registrar so your domain points at your cPanel hosting with us.
|
||||
- [Get your free SSL certificate](https://kb.anhonesthost.com/cpanel/free-ssl-certificate/): Every cPanel account includes free Let's Encrypt certificates through AutoSSL. Here's what has to be in place and what to do if one doesn't issue.
|
||||
- [Why is my site getting a 403 error?](https://kb.anhonesthost.com/cpanel/fix-a-403-error/): A 403 Forbidden on cPanel hosting is almost always file permissions or file ownership. Here's how to check and fix both.
|
||||
- [Send WordPress email from your own domain](https://kb.anhonesthost.com/cpanel/wordpress-email-from-your-domain/): Stop WordPress sending as user@server and send from an address on your domain instead, using an SMTP plugin and a real mailbox.
|
||||
|
||||
## Domains
|
||||
|
||||
- [Transferring a domain to us](https://kb.anhonesthost.com/domains/transferring-a-domain-to-us/): What happens after you start a domain transfer — the confirmation emails, how long it takes, and the nameserver check to do afterwards.
|
||||
- [Flush your DNS cache](https://kb.anhonesthost.com/domains/flush-your-dns-cache/): Your site moved or its DNS changed, but your computer still loads the old version? Clear the DNS cache your device has saved locally.
|
||||
|
||||
## Email
|
||||
|
||||
- [Set up your email](https://kb.anhonesthost.com/email/set-up-your-email-client/): Connect Outlook, Apple Mail, Thunderbird, or your phone to your mailbox — with the server settings for both WHP and cPanel hosting.
|
||||
- [Changes to spam filtering](https://kb.anhonesthost.com/email/spam-filtering-changes/): We're moving spam filtering from Baruwa to Proxmox Mail Gateway. What's changing, when, and what you need to do.
|
||||
|
||||
## Support
|
||||
|
||||
- [Remote support with RustDesk](https://kb.anhonesthost.com/support/remote-support/): Install and configure the RustDesk client so our support team can connect to your device and help directly.
|
||||
|
||||
## Optional
|
||||
|
||||
- [AnHonestHost KB homepage](https://kb.anhonesthost.com/): Start page for the knowledge base.
|
||||
- [Sitemap](https://kb.anhonesthost.com/sitemap-index.xml): XML sitemap index for all pages on this site.
|
||||
Reference in New Issue
Block a user