ray-haproxy

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 on this page — 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

ray-haproxy on PyPI

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

Evidence: ray_haproxy-2.8.25-py3-none-manylinux_2_17_aarch64.whl; ray_haproxy-2.8.25-py3-none-manylinux_2_17_x86_64.whl

Tags

More Proxy Servers packages