> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ultrabalancer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux Server

> Deploy UltraBalancer on Linux

## Install

```bash theme={null}
# One-command install (recommended)
curl -sSL https://package.ultrabalancer.com/install.sh | sh
```

Or download manually:

```bash theme={null}
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`:

```yaml theme={null}
listen_address: "0.0.0.0"
listen_port: 80
algorithm: "round-robin"

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

## Run

```bash theme={null}
# 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`:

```ini theme={null}
[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
```

```bash theme={null}
sudo systemctl daemon-reload
sudo systemctl enable --now ultrabalancer
```

## Firewall

```bash theme={null}
# 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

* [Configuration](/configuration/overview) - All config options
* [Monitoring](/integration/monitoring) - Set up dashboards
* [Docker](/deployment/docker) - Container deployment