Documentation

Welcome to the ProxLB documentation. Here you’ll find everything you need to get started with load balancing your Proxmox VE cluster.

What is ProxLB?

ProxLB (Proxmox Load Balancer) is an advanced tool designed to optimize resource distribution across Proxmox VE cluster nodes. It automatically analyzes resource usage and migrates virtual machines and containers to achieve better balance.

Key Features

• Automatic Load Balancing: Distributes VMs/CTs based on CPU, memory, or combined metrics
• Affinity Rules: Keep related workloads together or apart using VM groups
• Dry-Run Mode: Test changes before applying them
• Multiple Balancing Modes: CPU, memory, or combined resource balancing
• Systemd Integration: Runs as a background service
• API-Driven: Uses the official Proxmox VE API

Quick Links

• Getting Started - Install and configure ProxLB
• Installation - Detailed installation instructions
• Configuration - Configuration reference

Requirements

• Proxmox VE 7.x or 8.x
• Python 3.8+
• API access to your Proxmox cluster