A technical overview of the architecture, deployment model, license system, and update mechanism that powers HPanel.
HPanel runs as a self-contained application on your server with a secure connection to the license verification infrastructure.
HPanel installs as a Node.js application managed by PM2. It controls Nginx, PHP-FPM, MySQL, Postfix, Dovecot, and all server services through a unified API layer.
A centralized license server validates each HPanel installation. Licenses are bound to server IP and machine ID for security.
Production servers never receive raw source code. The backend is compiled and obfuscated using JavaScript obfuscation with control flow flattening, string array encoding, and dead code injection.
One script installs everything. No manual package management, no configuration editing, no dependency hunting.
Run a single wget command to download the production setup script. The script verifies system requirements before proceeding.
The script installs Nginx, PHP-FPM (multiple versions), MariaDB, Node.js, PM2, Postfix, Dovecot, ClamAV, Fail2Ban, Redis, Certbot, and all required libraries.
Enter your license key when prompted. The installer contacts the verification server, binds the license to your server's IP and machine ID, and activates the panel.
HPanel starts automatically via PM2. Access the admin dashboard at https://panel.yourdomain.com (your configured hostname). Create your first hosting account.
HPanel updates itself securely with version verification, automatic rollback, and zero-downtime deployment.
The panel checks for updates periodically. New versions are downloaded from the secure distribution server with checksum verification.
Every update package is verified against a manifest with SHA-256 checksums. Tampered packages are rejected automatically.
If an update fails or causes issues, HPanel automatically rolls back to the previous working version. No manual intervention needed.
React SPA
Tailwind CSS
Vite Build
Node.js + Express
JWT Auth
Rate Limiting
Background Jobs
Migrations
Backups
PostgreSQL
Connection Pool
Migrations
Nginx
PHP-FPM
MariaDB
Postfix
Dovecot
Get a license, run the installer, and have a production-ready panel in under 5 minutes.