---
id: ray-haproxy
version: "2.8.25"
license: GPLv2
license_treatment: copyleft
maintenance: active
---

# ray-haproxy — HAProxy binary distribution for Ray Serve

License: copyleft · Maintenance: active · Downloads: 117.8K/mo

## What it is and what it does

ray-haproxy packages a pre-compiled HAProxy binary with all its non-standard shared library dependencies (OpenSSL 3.0.x, Lua 5.4.x, PCRE, libxcrypt) vendored inside the wheel. This eliminates the need to install HAProxy at the system level before using Ray Serve. The package resolves the HAProxy binary in order: first checking the RAY_SERVE_HAPROXY_BINARY environment variable for an explicit override, then falling back to the bundled binary, and finally to any haproxy on the system PATH.

The bundled libraries are built from source or extracted from manylinux2014 containers to ensure compatibility across Linux distributions. Standard system libraries (libc, libz, libpthread, etc.) listed in PEP 599 are not vendored, as they are guaranteed to exist on compatible systems. This approach allows Ray Serve deployments to run HAProxy without requiring administrators to manage system package dependencies.

Use it for:

- Deploy Ray Serve on Linux systems where HAProxy is not pre-installed or where system package management is restricted.
- Containerize Ray Serve applications with a self-contained HAProxy binary, avoiding base image bloat from system package managers.
- Use Ray Serve's load balancing in CI/CD pipelines or ephemeral compute environments where system-level HAProxy installation is impractical.
- Override the default HAProxy binary via RAY_SERVE_HAPROXY_BINARY for testing or custom HAProxy builds.
- Ensure consistent HAProxy versions across heterogeneous Linux deployments (x86_64 and aarch64).

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a pre-built HAProxy binary bundled with its required shared libraries for use with Ray Serve, eliminating the need for system-level HAProxy installation.

Yes, if you are using Ray Serve on Linux (x86_64 or aarch64) and want to avoid system-level HAProxy installation. The package is actively maintained, has no known vulnerabilities, and solves a real dependency management problem. Be aware of the GPLv2 copyleft license if you are distributing derived works, and note that it is Linux-only with a Python >=3.9 requirement.

## Install

pip install ray-haproxy
uv add ray-haproxy
poetry add ray-haproxy

## Installing ray-haproxy

Before you install: Medium install friction due to platform-specific wheels (x86_64 and aarch64 Linux only). Package is actively maintained with a recent release cycle.

License in practice: Distributed under GPLv2 (copyleft). Any derivative work or distribution of this package must comply with GPLv2 terms, including source code disclosure obligations.

Quickstart:

pip install ray-haproxy

from ray_haproxy import get_haproxy_binary
print(get_haproxy_binary())  # /path/to/ray_haproxy/bin/haproxy

Linux x86_64 or aarch64 only; requires Python >=3.9; no Windows or macOS support.

Verify before relying:

- Whether Ray Serve automatically uses this package when installed, or if explicit configuration is required.
- Performance characteristics or overhead compared to system-level HAProxy installation.

## Package facts

- License: GPLv2 (copyleft)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 117.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

haproxy binary distribution, ray serve proxy, bundled haproxy, load balancer for ray, haproxy without system install, ray haproxy integration, pre-built proxy binary, ray-ecosystem, load-balancing, vendored-binary

[View on SkillFed](https://skillfed.io/packages/ray-haproxy) · [View on PyPI](https://pypi.org/project/ray-haproxy/)