Pre-built HAProxy binary distribution for Ray Serve.
The wheel bundles the HAProxy binary together with its vendored shared libraries (libssl, libcrypto, libpcre, liblua) so that Ray Serve can use HAProxy without requiring a system-level installation.
pip install "ray[serve,haproxy]"Or directly:
pip install ray-haproxy
- Linux x86_64 (
manylinux_2_17_x86_64) - Linux arm64 (
manylinux_2_17_aarch64)
from ray_haproxy import get_haproxy_binary
print(get_haproxy_binary()) # /path/to/ray_haproxy/bin/haproxyBinary resolution order:
RAY_SERVE_HAPROXY_BINARYenvironment variable (explicit override)- Bundled binary inside this package
haproxyon the system PATH
The wheel bundles HAProxy and the shared libraries it depends on that are
not guaranteed to exist on all Linux systems. At build time, the script
ci/build/build-haproxy-dist.sh compiles HAProxy inside a manylinux2014
container, then uses ldd to discover every .so the binary needs.
Libraries on the PEP 599 manylinux2014 allowlist (libc, libz, libpthread, etc.) are
skipped — they are guaranteed present on any compatible system. Everything
else is copied into lib/ and the binary's RPATH is patched to
$ORIGIN/lib so it finds its vendored copies at runtime.
| Library | Source | Why |
|---|---|---|
| OpenSSL 3.0.x (libssl, libcrypto) | Built from source | manylinux2014 ships OpenSSL 1.1.1 (EOL Sept 2023). We build 3.0.x (LTS, EOL Sept 2026) to get current security patches. |
| Lua 5.4.x | Built from source | HAProxy 2.8 requires Lua 5.3+. manylinux2014 only has Lua 5.1. |
| PCRE (libpcre, libpcreposix) | manylinux2014 system package | Discovered by ldd, not on the PEP 599 allowlist. Vendored
automatically. |
| libxcrypt (libcrypt.so.2) | manylinux2014 system package | Discovered by ldd. libcrypt.so.1 (glibc) is on the
allowlist, but libcrypt.so.2 (libxcrypt) is not. Must be
vendored — omitting it causes the binary to fail on systems that
only have libcrypt.so.1. |
Libraries not vendored (on the PEP 599 allowlist): libc, libm, libdl, librt, libpthread, libz, libgcc_s, libresolv, libcrypt.so.1.
HAProxy is distributed under the GNU General Public License v2. See LICENSE for details.