Repository navigation
Releases
Release v3.1.1
vPanel Pro v3.1.1
- Arix Theme v2.1.3 Full Integration
- Enterprise Virtualization Platform & Management Suite
- Real-time Telemetry, Multi-Session SSH Console, Live Boot Logs
- MongoDB State Persistence & Background Monitoring
Full Changelog: v3.1.0...v3.1.1
vPanel Pro v3.1.0 - Multi-Session SSH, noVNC Desktop, Live Boot Logs, OS Templates & Customization Studio
🚀 vPanel Pro v3.1.0 - Full Release Announcement
vPanel Pro v3.1.0 delivers a major set of enterprise-grade features, telemetry enhancements, UI customizations, and virtualization console tools.
🌟 Key Highlights & New Features
1. 🖥️ Default Terminal Size (169×33)
- Hardened Geometry: Terminal sessions and PTY shell streams default to 169 columns × 33 rows (
169×33). - Toolbar Quick-Action: Added
Default size (169×33)quick-reset button and telemetry badge in the console toolbar. - Smart Window Sizing: Automatically preserves preferred terminal geometry without layout distortion.
2. ⚡ Multi-Session SSH Terminal with 24/7 Background Persistence
- Multiple Shells: Add and toggle multiple concurrent SSH sessions with the
+and✕controls. - 24/7 Background Connection: Switching between SSH Terminal, noVNC Desktop, and Live Boot Logs keeps terminal connections alive in the background without disconnecting or killing shell jobs.
3. 🖱️ noVNC Graphic Desktop Remote Console
- Direct Framebuffer: Low-latency HTML5 remote graphic console connection to QEMU guests via WebSocket proxy (
/vncws/:id). - Control Bar: Integrated Ctrl+Alt+Del event dispatcher, viewport scaling, full-screen toggle, and live status indicator.
4. 📜 Live Kernel & Boot Logs Viewer
- Real-time QEMU serial boot log telemetry streaming via Socket.IO with instant log reset and filtering.
5. 📊 Resource Monitoring (/resources & /admin/resources)
- Visual Progress Meters: Live metrics for CPU Cores, RAM, NVMe/Disk, Bandwidth, and IPv4 allocations vs. real-time utilization.
- Color-Coded Telemetry: Status indicators and automated cluster host metrics.
6. 💿 OS Templates Studio (nobita329/Template.git)
- Integrated with https://github.com/nobita329/Template.git.
- 1-Click synchronization for 16 enterprise cloud-init OS templates across Debian (11, 12, 13), Ubuntu (22.04, 24.04), AlmaLinux 9, Rocky Linux 9, and CentOS Stream 9.
7. 🎨 Customization & AMOLED Dark Theme
- AMOLED Pure Dark Theme: System-wide pure black AMOLED theme (#000000) default.
- Glassmorphism Blur & Transparency Sliders: Dynamic card transparency (
--bg-card: rgba(...)) and backdrop filter blur. - 4K Wallpapers Studio: Curated 4K wallpapers gallery scraper with category filters, search, one-click apply, local image/video uploads, direct URLs, and favorites.
8. 🛡️ System Hardening & Resilience
- Multi-source token extraction (
Bearer, cookies,Sec-WebSocket-Protocol). - Resilient MongoDB connection retry mechanism (
ensureConnected). - Graceful PM2 cluster reload handling (
SIGTERM/SIGINT).
📦 Quick Installation (Debian / Ubuntu)
# Clone & install
git clone https://github.com/nobita329/vpanel-pro.git
cd vpanel-pro
sudo bash install.sh🔄 Updating Existing Installations
sudo bash install.sh update
# Or use the Web Panel: Admin -> Updates -> Update Now!Full Changelog: v3.0.0...v3.1.0
vPanel Pro v3.0.0 - Enterprise Virtualization Platform & Management Suite
⚡ vPanel Pro v3.0.0 — Enterprise-Grade Virtualization Platform
We are thrilled to announce vPanel Pro v3.0.0, moving beyond a standalone VM manager into a complete, modular, and enterprise virtualization platform (on par with Pterodactyl, Proxmox VE, and VirtFusion).
🚀 What is New in vPanel Pro v3.0.0
1. 👑 Strict 2-Panel UI Architecture
- Clean Separation: Total segregation between Administrative Control Plane (
/admin/*) and Tenant Workspace (/dashboard,/servers/:id/*). - 1-Click Switcher: Instant panel toggle in the topbar and sidebar.
2. 🗄️ MongoDB Management Studio (/admin/mongodb)
- Full-fledged Mongo Express style database management studio.
- Live database and collection breakdown, document viewer, JSON editor, and index manager.
- Raw query console with execution benchmark telemetry.
- Automated single-collection JSON exports and backups.
3. 💾 Storage Pools & ISO Library (/admin/storage)
- Multi-Type Storage Pools: Local Directory, LVM Volume Groups, and NFS mounts with real-time block allocation metrics.
- 1-Click Cloud ISO Library: Automated cloud downloads for Ubuntu 24.04/22.04 LTS, Debian 12 Bookworm, Alpine Linux 3.20, and Windows Server.
- Virtual Disk Catalog: Monitor VM qcow2 images, snapshot chains, and sparse allocation.
4. 🌐 Virtual Network & Firewall (/admin/network)
- Host network interface discovery (
br0,virbr0,eth0). - CIDR Subnet Pools with automatic IP address leases per VM.
- NAT Port Forwarding manager (Host Port -> VM Private IP).
- Stateful virtual firewall rules (
ALLOW/DROP, Inbound/Outbound, CIDR filtering).
5. ⚡ API Keys & Webhooks (/admin/api)
- Cryptographically secure API keys with
vp_live_prefix and granular permission scopes (vms:read,vms:write,users:read,admin:full). - Outgoing Webhooks with HMAC-SHA256 signature verification and delivery latency logging.
6. 🧩 Plugins Marketplace (/admin/plugins)
- Event-driven notifications dispatched to Discord Webhook Embeds, Telegram Bot Alerts, and Custom HTTP POST Webhooks.
7. 🎨 5-Theme Engine
- Selectable dynamic presets: Slate Glass (Flagship), Onyx Pure Black, Cyberpunk Neon, Arctic Nord, and Dracula Gothic.
8. 🔍 Global Command Palette (Ctrl + K / Cmd + K)
- Universal spotlight search across all admin sections, user servers, theme switches, and power actions.
9. 👤 Tenant User Impersonation ("Login as User")
- 1-click tenant impersonation from
/admin/userswith a high-visibility floating amber return banner and full security audit logging (auth:impersonate_start,auth:impersonate_end).
10. 🤖 AI Virtualization Boot Log Explainer
- Built-in intelligent diagnostic engine analyzing Kernel Panics, KVM permissions, OOM terminations, and corrupt disk headers with copyable shell remediation commands.
- Interactive modal integrated into
/servers/:id/console.
11. 💳 Billing & Resource Plans Module (/admin/billing)
- Compute tiers (Starter, Pro, Ultra, Enterprise), invoice ledger with payment status, promo discount coupons, and payment gateway setup.
12. 🔄 Pterodactyl-Style System Updates Center (/admin/updates)
- Automated GitHub release checks, pre-update snapshots, live SSE progress streaming (0%–100%), and 1-click rollbacks.
- Prominent update alert banners on the Admin Dashboard and an orange indicator badge (
Updates 🟠) in the sidebar.
13. 🌍 Internationalization (i18n) Engine
- Built-in localization support for English, Hindi (हिन्दी), Spanish (Español), German (Deutsch), and Arabic (العربية with RTL support).
📦 Quick Installation (Debian / Ubuntu)
# Clone & install
git clone https://github.com/nobita329/vpanel-pro.git
cd vpanel-pro
sudo bash install.sh🔄 Updating Existing Installations
sudo bash install.sh update
# Or use the Web Panel: Admin -> Updates -> Update Now!Full Changelog: v2.2.0...v3.0.0
vPanel Pro v2.2.0 - Debian/Ubuntu Installer Suite, No-KVM Engine & Nodes Telemetry
⚡ vPanel Pro v2.2.0 - Next-Gen QEMU Virtual Machine Management Web Panel
We are thrilled to announce vPanel Pro v2.2.0, introducing universal Debian & Ubuntu support, an interactive terminal management suite, hardware-agnostic No-KVM engine support, dual-series telemetry waveform charts, real-time boot logs, and VM ownership reassignment.
🚀 Key Highlights & What's New
1. 🛠️ Interactive Management & Installer Suite (install.sh)
- Universal OS Support: Full out-of-the-box support for Debian 11, 12, 13 and Ubuntu 20.04, 22.04, 24.04.
- Interactive 5-Option Terminal Menu:
1. Install: Complete automated installer installing dependencies, Node.js 20 LTS, QEMU, Cloud-Init, PM2, and admin provisioning.2. User Create Admin: Dedicated CLI wizard (usercrate admin) to create or reset root administrator credentials.3. Update: Zero-downtime updates with git pulling, dependency resolution, migrations, and cluster reloads.4. PM2 Management: Manage status, restart, stop, start, stream live logs, and toggle boot auto-start.5. Uninstall: Safe cleanup wizard with data preservation options.
2. ⚡ Dynamic No-KVM Mode (Universal VPS / Container Compatibility)
- Intelligent hypervisor engine automatically detects
/dev/kvmavailability. - When hardware acceleration is available: uses high-speed hardware KVM (
-machine accel=kvm:tcg,-cpu host). - When running in nested VPS, Docker, or environments without KVM: seamlessly switches to QEMU TCG software emulation (
-machine type=pc,accel=tcg,-cpu qemu64) withNO_KVM=1toggle.
3. 📊 Nodes & Real-Time Performance Telemetry (/admin/nodes)
- Dual-Series Canvas Waveform Charts: Smooth 30-point rolling history for CPU/RAM utilization and Network Inbound (RX) / Outbound (TX) throughput.
- Multi-Core Processor Load Matrix: Real-time load indicators for every individual CPU core.
- System Metrics: Host uptime counter, total RAM usage, disk usage, active VM density, and hypervisor runtime details.
4. 📜 Live Real-Time Boot Output & Logs
- Direct Server-Sent Events (SSE) streaming of VM boot process and serial console logs at
/servers/:id/console?tab=bootlog. - In-memory ring buffer capturing all QEMU startup output with ANSI stripping and clear log controls.
5. 🔄 VM Assignment & Ownership Transfer
- Assign Existing VM: 1-click modal in User Management (
/admin/users/:id) to assign any existing VM to a user. - Transfer Owner: Directly change server ownership from both the Admin Server Details page (
/admin/servers/:id) and the VM Overview page (/servers/:id).
6. 🎨 Settings, Branding & UI Polish
- General Settings: Custom Panel Name, Panel Logo Upload/URL with live preview, and Favicon Upload/URL with dynamic letter badge preview.
- Authentication: High-contrast "Create New Account" and "Sign In" reciprocal navigation.
- Automated Test Suite: 42 automated end-to-end tests (
npm test) with 100% pass rate.
📦 Quick Installation (Debian / Ubuntu)
# Run the interactive management menu
sudo bash install.sh🔄 Updating Existing Installation
sudo bash install.sh update
# Or using the menu: sudo bash install.sh -> Option 3Full Changelog: v2.0.0...v2.2.0
vPanel Pro v2.0.0 - Next-Gen QEMU Virtual Machine Management Web Panel
🚀 vPanel Pro v2.0.0
✨ Key Highlights & Features:
- Full Glassmorphism Web Panel Overhaul: Dynamic translucent dark glass UI with live accent lighting.
- Integrated 4K Wallpaper Studio: Direct wallpaper browser, category filters, search, live preview, favorites, and 1-click apply from 4kwallpapers.com.
- Live Transparency & Glassmorphism Blur Controls: Smooth sliders for real-time CSS backdrop blur and opacity adjustment.
- Web Terminal & Serial Boot Logs: Dual-tab SSH console and QEMU kernel serial startup log viewer.
- Overhauled File Manager: Accurate file size formatting, large code editor modal, and multi-file drag-and-drop uploads.
- Interactive VM Creation Wizard: Quick hardware sizing presets, distro selectors, and live deployment blueprint.
📦 Installation
git clone https://github.com/nobita329/vpanel-pro.git
cd vpanel-pro
npm install
npm startVPanel Pro Beta v2.1
# 🚀 VPanel Pro Beta Test v2.1
New video coming soon! 🎥
VPanel Pro v2.1 is coming with new improvements, better performance, and more control.
✨ What's New
- 🎨 New & improved UI
- 🖥️ Better VPS Management
- ⚡ Improved performance
- 🛠️ More control & management tools
- 🐛 Bug fixes
- 🔒 Stability improvements
- 🚀 Overall system improvements
🔥 More Features Coming
We're continuing to improve VPanel Pro with more powerful features and tools.
VPanel Pro v2.1 — Beta Test starts soon!
Stay tuned for the new video. 🎥🚀