Advanced Search
Search Results
15 total results found
Introduction
A message from the developers. ServersCTL started life as a solution to a problem many of us face: HAProxy is often the single point of failure in an otherwise resilient infrastructure. The original goal was simple. Build a way to monitor HAProxy instances and...
Requirements
Server Stack Operating system Supported: Debian/Ubuntu and RHEL family (AlmaLinux, Rocky, CentOS). Init: systemd (required — agent is designed as a systemd unit). Architecture: Linux x86_64 (typical VPS; agent uses standard distro package managers). Runtime de...
Register & Install the Agent
Installation When adding a pool, you will be asked whether the pool will be for HAProxy nodes. Only select the HAProxy Pool Template if the backend server(s) are currently running, or will be running, HAProxy. For all other server types—including cPanel, Open...
Overview & concepts
What is an HAProxy pool? An HAProxy pool is a ServerCTL deployment preset for the edge tier: public DNS, one or more enrolled Linux VMs running HAProxy, and optional automatic promotion when the active host fails. ServerCTL is the control plane. It does not te...
Create your first pool & Enroll your first member
Create your first pool Step 1 — Add pool Go to Pools → Add pool Choose the HAProxy template Name the pool (e.g. production-edge) After create, you land in the pool with a setup banner Step 2 — Connect DNS (Settings) ServerCTL needs API access to authoritative...
Pool workspace (Overview, Settings, DNS, DR, Monitoring)
Pool workspace The pool page has a tab bar with three groups: Overview (pool home) Member tabs (one per enrolled host) Pool tools (DR, Monitoring, Settings, Managed DNS) Overview tab For HAProxy pools, Overview answers: Is traffic on the active node? Are stand...
Pool members & enrollment
Member tab layout Click a member in the tab bar to open its workspace. Sub-tabs: Tab Purpose Control panel Host ops: reboot, updates, hostname, TLS domain (non-HAProxy PEM) Security UFW firewall, SSH enable/disable, firewall backup Status Live HAProxy traffi...
DNS failover & traffic cutover
Manual cutover Make active on a standby member → ServerCTL sets it as primary and updates the managed A record to its public IPv4. Cut DNS to standby on Overview → promotes next failover-ready standby (same DNS update, overview-oriented workflow). Automatic fa...
HAProxy operations
Install & lifecycle Action Command ID Notes Install HAProxy haproxy.provision Fresh VM Re-install haproxy.provision + force: true Overwrite install path Reload haproxy.reload After config edits Provision standby from backup standby.provision_from_backup Clone...
Backups & disaster recovery
What gets backed up HAProxy backup job captures: /etc/haproxy/haproxy.cfg and conf.d/*.cfg /etc/haproxy/certs/* Let’s Encrypt material under /etc/letsencrypt/ Paths referenced by ssl crt in config under /etc/ Optional UFW rules ( backup.ufw) — separate job...
Recipes & scheduled jobs
Recipes (member → Recipes tab) Recipe When Enable HAProxy admin stats socket HAProxy detected Enable SSH access Always available Let’s Encrypt (failover / HAProxy) HAProxy + Cloudflare + failover FQDN Update agent When agent version outdated Recipes show steps...
Agent reference
Heartbeat payload (HAProxy-relevant) The agent sends JSON including: ip — declared/probed IPv4 hostname haproxy block — monitored, active, topology, listeners, optional show stat summary ServerCTL validates IP against enrollment and stores the latest row per ...
Troubleshooting & FAQ
Symptom Likely cause Fix 403 on heartbeat Wrong allowed IP or hostname Update allowed IPs; set BALCTL_HOSTNAME 401 unknown credential Used member UUID instead of enrollment secret Re-enroll; use 48-char secret from modal No HAProxy on card No config / unit no...
Part 1 - Overview & Concepts
What ServersCTL hosting pools are ServersCTL (serversctl.com) is the control plane for redundant server infrastructure: enrol Linux VMs with the ServersCTL agent, monitor heartbeats, cut over DNS between peers, run stack backups, and (on the cPanel preset) orc...
Part 2 - Member workspace (per-server tabs)
Member tab bar (Generic Linux Server Pool) Tab Always in nav? Active when Control panel Yes Always Security Yes Always OpenLiteSpeed Yes (Generic) Content when OpenLiteSpeed detected; else frosted not detected overlay MariaDB Yes (Generic) Content when MariaDB...