Drop in our WHMCS addon and every server you sell appears in the admin panel with live up/down status. Each logged-in client sees only the monitors mapped to the products, servers, or client groups they actually own. Free to use with any Duck Stats plan — your tier caps how many monitors you can expose (50 / 200 / 1000 / unlimited).
All three render inside your WHMCS shell — admin sidebar, client portal, dashboard widget. No template overrides required.
Plugin reads monitors from a status-page slug via your Duck Stats API key. New monitors appear in the admin grid automatically on every page load — no manual sync button to babysit. A Sync from Duck Stats button is there if you want to force one.
Each monitor can be set to All Users, or restricted by any combination of WHMCS products, servers (tblservers), client groups, or a free-form list of client IDs. Visibility is a union — a monitor shows if any rule matches.
A logged-in client gets a Network Status menu entry at /index.php?m=duckmonitor. They only see the monitors tied to their active services / addons / group. No leakage between customers.
Up/Down/Paused pill, 24h / 7d / 30d / 365d uptime tiles, last-ping latency, a Chart.js response-time mini-chart, and a heartbeat strip of the last 30 checks.
Rename a monitor for client display without touching the original. Useful when your internal name is node-07-fra-emby but you want clients to see Frankfurt Streaming Node.
Order monitors with a numeric sort field. Temporarily hide one without deleting the mapping via a per-row Enabled checkbox.
Monitor list is cached in WHMCS for a configurable interval (default 2 min). Raise it to drop Duck Stats API calls on a busy portal; lower it for near-real-time freshness.
Switch the entire panel between loggedin (default) and public. Public mode turns your WHMCS into a customer-facing status page that lives at your-billing-host/index.php?m=duckmonitor.
Phones license.duckingstats.com once per 7 days. If the license server is unreachable, plugin keeps working for a 30-day grace window. If the license is invalid, the panel renders a friendly box — your billing pages keep working.
A single Save All writes every mapping in one POST, or save a single monitor in place via AJAX. Both paths are CSRF-protected via WHMCS's admin session.
All failures (license curl errors, API non-200s, bad JSON) are written to WHMCS's Utilities → Logs → Activity Log with the duckmonitor: / duckmonitor api: prefix.
Hit Deactivate and both internal tables (duck_monitor_map, duckmonitor_license) are dropped. Then delete the module folder. No leftover schema, no leftover settings.
Plugin zip is issued per WHMCS install — not a public download. Each install is bound to one hostname; the panel runtime checks back to license.duckingstats.com every 7 days.
No exotic extensions. Just cURL and outbound HTTPS.
Email [email protected] with your WHMCS hostname. We email back your license key + a signed one-time download link tied to that hostname.
Unzip and upload so duckmonitor.php lands at /modules/addons/duckmonitor/duckmonitor.php. The whole tree:
WHMCS Admin → Setup → Addon Modules → find Duck Monitor → Activate. The activate hook auto-creates the duck_monitor_map and duckmonitor_license tables.
Open Duck Monitor → Configure and fill in:
DS-XXXX-XXXX-XXXX-XXXX, from your Duck Stats account.stats.duckingstats.com → Settings → API Keys.Grant Access Control to the admin role(s) that should see the addon page.
Open the addon page (sidebar → Duck Monitor). For each monitor, pick All Users or Selected, then tick the products, servers, groups or client IDs that should see it. Hit Save All. Done.
A license key activates the plugin. A separate API key reads your Duck Stats account. Keeping them apart means you can roll either one without re-activating the other — rotate API keys quarterly without touching the license.
sha256(whmcs_install_id || hostname) — one license, one install.We benchmarked against two of the most popular WHMCS marketplace modules in the same lane: WS Server Monitoring and WS UptimeRobot Status from whmcsservices.com. Here's what's on the tin.
| Capability | Duck Monitor | WS Server Monitoring | WS UptimeRobot Status |
|---|---|---|---|
| Monitoring engine | Duck Stats — multi-region probes from our fleet | Self-hosted inside WHMCS — single-region cron in your billing box | Pulls from UptimeRobot — single-region pull |
| Multi-region consensus (kills false alarms) | Yes — 4 regions, configurable quorum | No — one box runs the checks | No — UptimeRobot's free plan is single-region |
| Per-monitor product mapping | Yes — products, servers, groups, client IDs (union) | Yes — product-based packages | Yes — products, selected clients, public, logged-in |
| Push monitors (for boxes behind NAT) | Yes — cron heartbeats + process watchers | No | No |
| DB health inspector (slow queries, replica lag, buffer pool) | Yes — MySQL monitor opt-in | No — MySQL = port alive only | No |
| Free tier | Yes — 50 monitors free forever | No — license $-paid | No — $29.99 license |
| SMS alerts to clients (BYO SMS gateway) | Partial — we alert you via SMS (BYO Twilio); the WHMCS plugin shows status, doesn't send client SMS | Yes — member-level SMS opt-in via WS SMS Manager | No |
| Auto-open WHMCS ticket on downtime | No (flagged as a gap) — we alert via email/webhook; auto-ticket on the WHMCS side is on the roadmap | Yes — ticket auto-created when a monitor goes down | No |
| Resold monitoring as a product (clients pay you to monitor their sites) | No (flagged as a gap) — Duck Monitor surfaces your servers to clients; we don't yet support clients adding their own URLs through WHMCS | Yes — that's the whole product | No |
| Public status page outside WHMCS | Yes — first-class status pages on your own domain, with subscribe + incidents | Limited — inside WHMCS only | Yes — UptimeRobot's own status pages |
| Live response-time chart per monitor | Yes — Chart.js, p50/p95/p99 | Basic | Basic |
| 365-day uptime tiles | Yes | Not by default | No |
| Open REST API | Yes — GET /api/v1/monitors with bearer auth | Limited — add/edit/delete/up-or-down only | No |
| White-label / multi-brand | Yes on Team / Enterprise tiers | No | No |
| Discord status board | Yes — per-monitor custom emoji, 90s refresh | No | No |
| Distribution | License-bound — one zip per WHMCS hostname, runtime gate | License-bound | License-bound · ionCube-encoded |
| License cost | Included free with any Duck Stats plan | License (varies) · source license extra | License $29.99 · source $249.99 |
Comparison reflects publicly listed features on whmcsservices.com as of 2026-06-29. Where they have a feature we don't, we've flagged it in amber so you can ask before you buy. If you need one of those now, email [email protected] — the auto-ticket-on-down case is small.
Assign your Hetzner FSN1 monitor to the product Premium VPS Frankfurt. Customers on that plan see Frankfurt status without seeing your London or Dallas tiles. Status-driven support tickets drop by half.
Map your Emby cluster A monitor to the client group Emby Power Users. They get a real-time view of the cluster they pay for; everyone else doesn't see it at all.
Switch the plugin to public visibility and you've got a logged-out-friendly status page right inside your WHMCS shell — no separate subdomain to set up.
stats.duckingstats.com → Settings → License keys. Format: DS-XXXX-XXXX-XXXX-XXXX. While we wire up self-serve checkout, email [email protected] and we'll issue one in under an hour.sha256(whmcs_install_id || hostname) on first check. If you need to monitor two billing portals, you need two licenses — or pay for the Source/Multi-install tier (email us). Moving a single install to a new host is fine; just contact support to reset the fingerprint.{license_key, fingerprint, plugin_version}. Monitor reads pull from your Duck Stats account via your API key — we don't receive WHMCS customer data, invoices, or tickets. The mapping between monitors and your WHMCS products is stored only in your local database (duck_monitor_map).Five minutes to install, no template hacks, free with any Duck Stats plan.
