Advanced Search
Search Results
37 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 traffic ...
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...
Introduction
Storage Pools Storage Pools are the central distribution platform for ServersCTL. Publish backups, configuration files and deployment packages from browsers, agents or external software, then compare, version, schedule and deploy them safely across your infras...
Member Tab Bar
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/MySQL detected or cPanel-managed MySQL cPa...
Overview Tab
Member Overview Purpose: Host-level operations on this Server — OS family, uptime, services, quick actions, TLS. What you see Section Content Health strip Agent version, heartbeat age, firewall summary Console Open a secure SSH session to the member KPI row CP...
Security Tab
Member Security Tab: Security. Use the Security tab to check and manage host-level firewall and SSH access for one server in a hosting pool. It is for server access control, not website, database, or cPanel account security. What you can do Area What it is for...
OpenLiteSpeed Tab
Member OpenLiteSpeed Tab: OpenLiteSpeed. Sub Tabs: Overview, Recovery Wizard Use the OpenLiteSpeed tab to manage standalone OpenLiteSpeed servers in a hosting pool. It gives you one place to check the web server, create recovery points, restore sites, and move...