Skip to main content

​
Install

# One-command install (recommended)
curl -sSL https://package.ultrabalancer.com/install.sh | sh
Or download manually: 
curl -LO https://github.com/bas3line/ultrabalancer/releases/latest/download/ultrabalancer-3.0.0-x86_64-unknown-linux-gnu.tar.gz
tar -xzf ultrabalancer-*.tar.gz
sudo mv ultrabalancer-*/ultrabalancer /usr/local/bin/

​
Config File

Create /etc/ultrabalancer/config.yaml: 
listen_address: "0.0.0.0"
listen_port: 80
algorithm: "round-robin"

backends:
  - host: "backend1.internal"
    port: 8080
  - host: "backend2.internal"
    port: 8080

​
Run

# From config file
ultrabalancer start -c /etc/ultrabalancer/config.yaml

# Or from CLI
ultrabalancer start round-robin backend1:8080 backend2:8080 -p 80

​
Systemd Service

Create /etc/systemd/system/ultrabalancer.service: 
[Unit]
Description=UltraBalancer
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/ultrabalancer start -c /etc/ultrabalancer/config.yaml
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now ultrabalancer

​
Firewall

# UFW (Ubuntu)
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# firewalld (CentOS)
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload

​
Next Steps