haproxy

Manage and troubleshoot HAProxy load balancer configurations and runtime operations.

6|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill haproxy-l3digitalnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: haproxy
Source: https://github.com/L3DigitalNet/Claude-Code-Plugins/tree/main/plugins/linux-sysadmin/skills/haproxy
Command: npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill haproxy-l3digitalnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive management and troubleshooting capabilities for HAProxy, a high-performance load balancer and proxy server, ensuring optimal network traffic distribution and availability.

Core Features & Use Cases

  • Configuration Management: Understand and manage HAProxy configuration syntax, frontend/backend sections, and ACLs.
  • Operational Control: Perform graceful reloads, validate configurations, and manage server states via the stats socket.
  • Troubleshooting: Diagnose common failures related to port binding, health checks, SSL, and connection timeouts.
  • Use Case: You need to add a new server to an existing HAProxy backend without dropping any active connections. This Skill can guide you through the process of draining the old server and enabling the new one.

Quick Start

Validate the HAProxy configuration file located at /etc/haproxy/haproxy.cfg.

Frequently Asked Questions about haproxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new server to an HAProxy backend without dropping active connections?

To add a server without dropping connections, drain the old server via the stats socket and enable the new one. This graceful migration ensures zero downtime during backend pool changes.

How do I validate an HAProxy configuration file before reloading the service?

Validate your HAProxy configuration file located at /etc/haproxy/haproxy.cfg before reloading. This syntax check prevents service disruptions caused by malformed routing rules or ACLs.

Why does my HAProxy load balancer fail to bind to a port or timeout during health checks?

HAProxy port binding and health check timeouts often fail due to misconfigured backend targets or firewall rules. Diagnose these common failures using runtime stats socket interactions.

Can I dynamically manage HAProxy server states and routing rules without restarting the service?

Manage HAProxy server states dynamically using the runtime stats socket API. This socket communication allows operational control and server state changes without full service restarts.

Does this HAProxy configuration tool support both TCP and HTTP traffic with SSL termination?

HAProxy configuration management supports both TCP and HTTP traffic routing. It covers SSL termination setup, frontend/backend sections, and ACLs for high-performance network proxying.

What is the best way to troubleshoot HAProxy proxy server configuration and routing rules?

The best way to troubleshoot HAProxy proxy server issues is by diagnosing configuration syntax, routing rules, and runtime API interactions. This covers health checks, SSL, and connection timeouts.