Skip to main content
Advanced Search
Search Terms
Content Type

Exact Matches
Tag Searches
Date Options
Updated after
Updated before
Created after
Created before

Search Results

15 total results found

Introduction

Getting Started

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

Getting Started

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

Getting Started

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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)

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started HAProxy Server Pools

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

Getting Started Linux Server Pools

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)

Getting Started Linux Server Pools

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...