Skip to main content

​
Overview

UltraBalancer can be installed via pre-built binaries or compiled from source. We support all major Linux distributions, macOS, and Windows (via WSL).
No package managers yet - We don’t have Homebrew, apt, or yum packages. Use pre-built binaries or build from source.

​
Quick Install

# Download latest release
curl -LO https://github.com/bas3line/ultrabalancer/releases/latest/download/ultrabalancer-linux-x86_64

# Make executable
chmod +x ultrabalancer-linux-x86_64

# Move to system path
sudo mv ultrabalancer-linux-x86_64 /usr/local/bin/ultrabalancer

# Verify installation
ultrabalancer --version

​
Build from Source

Building from source gives you the latest features and optimizations for your specific CPU architecture.

​
Prerequisites

1

Install Rust

UltraBalancer requires Rust 1.75 or higher.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
Verify installation:
rustc --version
cargo --version
2

Install Build Dependencies

sudo apt update
sudo apt install -y build-essential pkg-config libssl-dev git
3

Clone Repository

git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
4

Build Release Binary

cargo build --release
This will take 2-5 minutes depending on your CPU. The optimized binary will be at:
target/release/ultrabalancer
The release build is highly optimized with LTO (Link-Time Optimization) and will be significantly faster than debug builds.
5

Install System-Wide

# Install to /usr/local/bin
sudo cp target/release/ultrabalancer /usr/local/bin/

# Or install to ~/.cargo/bin (already in PATH if you installed Rust)
cp target/release/ultrabalancer ~/.cargo/bin/
Verify:
ultrabalancer --version
ultrabalancer info

​
Docker Installation

docker pull ghcr.io/bas3line/ultrabalancer:latest

​
Verification

After installation, verify everything works: 
ultrabalancer --version
# Output: ultrabalancer 1.0.0

​
Platform-Specific Notes

Fully supported - Recommended for production servers.
# Install dependencies
sudo apt update
sudo apt install -y curl build-essential

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Clone and build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
sudo cp target/release/ultrabalancer /usr/local/bin/
Ubuntu 22.04 is the recommended platform for production deployments.
Fully supported - Excellent for production.
# Install dependencies
sudo apt update
sudo apt install -y curl build-essential pkg-config libssl-dev

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
sudo install -m 755 target/release/ultrabalancer /usr/local/bin/
Supported - May need newer OpenSSL for CentOS 7.CentOS 7 requires EPEL and newer OpenSSL:
# Enable EPEL
sudo yum install -y epel-release

# Install dependencies
sudo yum groupinstall "Development Tools"
sudo yum install -y openssl11-devel pkg-config git

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Build with openssl11
export OPENSSL_DIR=/usr/lib64/openssl11
export PKG_CONFIG_PATH=/usr/lib64/openssl11/pkgconfig

git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
CentOS 8/Stream:
sudo dnf groupinstall "Development Tools"
sudo dnf install -y openssl-devel pkg-config git
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
Fully supported - Enterprise-ready.
# Register system (if not already)
sudo subscription-manager register

# Install dependencies
sudo dnf groupinstall "Development Tools"
sudo dnf install -y openssl-devel pkg-config git

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
sudo cp target/release/ultrabalancer /usr/local/bin/
Fully supported - Rolling release, always latest.
# Install dependencies
sudo pacman -Syu
sudo pacman -S base-devel openssl git rustup

# Setup Rust
rustup default stable

# Build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
sudo install -Dm755 target/release/ultrabalancer /usr/local/bin/ultrabalancer
Consider creating a PKGBUILD for AUR if you want to share with the Arch community.
Supported - Perfect for Docker/containers.
# Install dependencies
apk add --no-cache build-base openssl-dev pkgconfig git rust cargo

# Build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release
install -m 755 target/release/ultrabalancer /usr/local/bin/
Alpine uses musl libc, which produces smaller binaries:
# Check binary size
ls -lh target/release/ultrabalancer
# Usually 50-60% smaller than glibc builds
Fully supported - Works on all modern Macs.
# Install Xcode Command Line Tools
xcode-select --install

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Build
git clone https://github.com/bas3line/ultrabalancer.git
cd ultrabalancer
cargo build --release

# Install
sudo cp target/release/ultrabalancer /usr/local/bin/
M1/M2/M3 Macs (Apple Silicon) will build ARM64 binaries automatically, which are significantly faster than Intel builds.

​
Upgrading

# Download latest version
curl -LO https://github.com/bas3line/ultrabalancer/releases/latest/download/ultrabalancer-linux-x86_64

# Replace existing binary
sudo mv ultrabalancer-linux-x86_64 /usr/local/bin/ultrabalancer
chmod +x /usr/local/bin/ultrabalancer

# Restart service
sudo systemctl restart ultrabalancer

​
Uninstallation

sudo rm /usr/local/bin/ultrabalancer

​
Troubleshooting

If rustup fails to install:
# Try manual installation
curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain stable -y

# Or download from rust-lang.org
wget https://static.rust-lang.org/rustup/dist/x86_64-unknown-linux-gnu/rustup-init
chmod +x rustup-init
./rustup-init
If cargo build fails with OpenSSL errors:Ubuntu/Debian:
sudo apt install -y libssl-dev pkg-config
CentOS/RHEL:
sudo yum install -y openssl-devel pkg-config
Set OpenSSL path manually:
export OPENSSL_DIR=/usr/lib/ssl
export PKG_CONFIG_PATH=/usr/lib/pkgconfig
cargo build --release
If you can’t write to /usr/local/bin:
# Install to user directory instead
mkdir -p ~/.local/bin
cp target/release/ultrabalancer ~/.local/bin/

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"
Check if /usr/local/bin is in your PATH:
echo $PATH | grep /usr/local/bin
If not, add it to your shell config:
# For bash
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

​
Next Steps

Quickstart Guide

Get UltraBalancer running in 5 minutes

Configuration

Learn about all configuration options

Deploy to Server

Production deployment on Linux servers

Testing

Test your load balancer setup