Modern Multi-Cluster Management for Proxmox VE

Website • Documentation • Releases

PegaProx is a powerful web-based management interface for Proxmox VE clusters. Manage multiple clusters from a single dashboard with features like live monitoring, VM management, automated tasks, and more.

• 🖥️ Unified Dashboard - Manage all your Proxmox clusters from one place
• 📊 Live Metrics - Real-time CPU, RAM, and storage monitoring
• 🔄 Live Migration - Migrate VMs between nodes with one click

• ▶️ Quick Actions - Start, stop, restart VMs and containers
• ⚙️ VM Configuration - Edit CPU, RAM, disks, network, EFI, Secure Boot & more
• 📸 Snapshots - Create and restore snapshots
• 💾 Backups - Schedule and manage backups
• 🖱️ noVNC Console - Direct browser-based console access
• ⚖️ Load Balancing - Automatic VM distribution across nodes
• 🔁 High Availability - Auto-restart VMs on node failure
• 📍 Affinity Rules - Keep VMs together or apart on hosts

• 👥 Multi-User Support - Role-based access control (Admin, Operator, Viewer)
• 🔐 2FA Authentication - TOTP-based two-factor authentication
• 🛡️ VM-Level ACLs - Fine-grained permissions per VM
• 🏢 Multi-Tenancy - Isolate clusters for different customers

• ⏰ Scheduled Tasks - Automate VM actions (start, stop, snapshot, backup)
• 🚨 Alerts - Get notified on high CPU, memory, or disk usage
• 📜 Audit Logging - Track all user actions
• 🔧 Custom Scripts - Run scripts across nodes

• 🌐 Offline Mode - Works without internet (local assets)
• 🎨 Themes - Dark mode, Proxmox theme, and more
• 🌍 Multi-Language - English and German language support
• 📱 Responsive - Works on desktop and mobile

• Python 3.8+
• Proxmox VE 8.0+ or 9.0+
• Modern web browser (Chrome, Firefox, Edge, Safari)

# Download the deployment script
curl -O https://raw.githubusercontent.com/PegaProx/project-pegaprox/refs/heads/main/deploy.sh

# Give the deployment script permission
chmod +x deploy.sh

# Run the deployment script
sudo ./deploy.sh

# Clone the repository
git clone https://github.com/PegaProx/project-pegaprox.git
cd project-pegaprox

# Install dependencies
pip install -r requirements.txt

# Run PegaProx
python3 pegaprox_multi_cluster.py

This solution is only for development and testing and you should take special care about the sqlite db in the config path.

# Clone the repository
git clone https://github.com/PegaProx/project-pegaprox.git

# Build Docker Image
docker build -t pegaprox .

# Run the image
docker run -p 5000:5000 pegaprox

Option 1: Update Script (Recommended)

#Go in the Folder
cd /opt/PegaProx

#Download it with this command. 
curl -O https://raw.githubusercontent.com/PegaProx/project-pegaprox/refs/heads/main/update.sh

#Permissions adjustment for the File so we can run it
chmod +x update.sh

#Please execute this then
sudo ./update.sh 
or
./update.sh 

Option 2: Manual

#Go in the Folder
cd /opt/PegaProx

curl -O https://raw.githubusercontent.com/PegaProx/project-pegaprox/main/pegaprox_multi_cluster.py
curl -O web/index.html https://raw.githubusercontent.com/PegaProx/project-pegaprox/main/web/index.html
curl -O https://raw.githubusercontent.com/PegaProx/project-pegaprox/main/requirements.txt

# Install dependencies (choose one):
pip3 install -r requirements.txt                # System Python
./venv/bin/python -m pip install -r requirements.txt      # Virtual environment
Can also work with: ./venv/bin/pip install -r requirements.txt 

sudo systemctl restart pegaprox

• Fixed Force Stop for LXC containers
• Fixed Web Updater
• Fixed pagination error in pre-compiled builds (#4)
• Added update.sh for easy updates
• Added build.sh for JSX pre-compilation (devs only)

After starting PegaProx, open your browser and navigate to:

https://your-server-ip:5000

Please use the following default credentials for the first login:

Username: pegaprox
Password: admin

Afterwards, please proceed with the following steps:

1. First Login: Create your admin account on the setup page
2. Add Cluster: Go to Settings → Clusters → Add your Proxmox credentials
3. Done! Start managing your VMs

/opt/PegaProx/
├── pegaprox_multi_cluster.py   # Main application
├── web/
│   └── index.html              # Frontend
├── config/
│   ├── pegaprox.db             # SQLite database (encrypted)
│   └── ssl/                    # SSL certificates
├── logs/                       # Application logs
└── static/                     # Offline assets (optional)

• All data is encrypted with AES-256-GCM
• Passwords are hashed with Argon2id
• HTTPS is required for production use
• Session tokens expire after inactivity
• Rate limiting protects against brute force

Full documentation is available at docs.pegaprox.com

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

• 📧 Email: support@pegaprox.com
• 🐛 Issues: GitHub Issues

If you find PegaProx useful, please consider giving it a star! ⭐

Made with ❤️ by the PegaProx Team