7c42de11a3
- proxmox/__init__.py: re-export get_next_vmid, save_vm_instance, get_vm_instance so templates.py import doesn't raise ImportError (regression introduced in Q3 split) - ipam.py:791: remove erroneous await on non-async get_orphan_allocations() (missed in Q2 async cleanup) https://claude.ai/code/session_019rK2wvaWg5zXFwmAPPEB7R
🖥️ PVEmanager
Modern web panel for managing Proxmox servers, virtual machines and LXC containers.
✨ Key Features
- 🖥️ Proxmox Integration — Manage multiple servers and clusters
- 🎛️ VM/LXC Management — Start, Stop, Restart, Delete, Resize
- ⚡ Bulk Operations — Mass start/stop/restart/delete VMs and containers
- 🖵 VNC Console — Built-in console via noVNC
- ⌨️ Remote Commands — Bash via QEMU Guest Agent
- 📸 Snapshots — Create, delete, rollback VM/LXC snapshots with queue system
- 📋 OS Templates — Quick VM deployment from templates
- 🔄 Cross-Node Templates — Deploy templates to any cluster node with auto-replication
- 📦 Smart LXC Creation — Create containers from templates on any node with auto-migration
- 🌐 IPAM — IP Address Management
- 🔔 Notifications — Email, Telegram, In-App
- 📊 Monitoring — CPU, RAM, Disk, Network in real-time
- 🔒 Security — RBAC v2, IP blocking, session management, login protection
- 🌍 Multilingual — Russian and English
🚀 Quick Start
# Clone repository
git clone https://github.com/your-repo/pvemanager.git
cd pvemanager
# Copy configuration
cp .env.example .env
cp backend/.env.example backend/.env
# Start
docker compose up -d
# Open http://localhost:8000
# Login: admin / Password: admin123
⚠️ Make sure to change password after first login!
📖 Documentation
| Document | Description |
|---|---|
| 📖 WIKI.md | Complete User & Admin Guide |
| 📝 CHANGELOG.md | Change History |
🔔 Notifications
Notification system supports:
- In-App — Bell icon with badge in UI
- Email — SMTP (Yandex, Gmail, Mail.ru)
- Telegram — Via Bot API
Settings: Settings → Notifications
🛠️ Tech Stack
| Component | Technology |
|---|---|
| Backend | FastAPI + Python 3.12 |
| Frontend | Jinja2 + Vanilla JS |
| Database | PostgreSQL 16 |
| Container | Docker + Alpine |
| Proxmox API | proxmoxer |
| VNC | noVNC |
📋 Requirements
- Docker & Docker Compose
- 2GB RAM minimum
- Proxmox VE 7.x / 8.x / 9.x
🔧 Configuration
Main Variables (.env)
POSTGRES_PASSWORD=your_secure_password
TZ=Your/Timezone
Private Repository Configuration
For private repositories, update checks need to be configured:
# Disable update checks completely
DISABLE_UPDATE_CHECK=true
# OR use GitHub token for access
GITHUB_TOKEN=your_github_personal_access_token
To create GitHub token: https://github.com/settings/tokens (needs 'repo' scope)
Notifications (SMTP and Telegram)
Email and Telegram notification settings are now managed via web interface:
- Open Settings → Notifications
- Fill in SMTP server details for email notifications
- Enter Telegram bot token for Telegram notifications
🤝 Contributing
- Fork the repository
- Create feature branch
- Commit changes
- Push and create Pull Request
📜 License
MIT License — see LICENSE
📞 Support
Made with ❤️ for Proxmox users