mirror of
https://github.com/usmannasir/cyberpanel.git
synced 2026-02-16 19:46:48 +01:00
70163e3a50
- cyberpanel.sh: Add Ubuntu 24.04 detection, update supported-OS message - simple_install.sh: Add Ubuntu 24.04, AlmaLinux 10; use dnf for Alma 8 - cyberpanel_utility.sh: Add Ubuntu 24.04 to OS detection and supported list - CPScripts/mailscanner*.sh: Add Ubuntu 24.04, AlmaLinux 9/10 to supported list - serverStatus/views.py: Prefer dnf.conf for package locks on dnf-based systems - README.md: Recommend AlmaLinux; add aarch64 note - Remove .DS_Store from repo Co-authored-by: Cursor <cursoragent@cursor.com>
CyberPanel
Web Hosting Control Panel powered by OpenLiteSpeed Fast • Secure • Scalable — Simplify hosting management with style.
Version: 2.5.5-dev • Updated: November 15, 2025
Key highlights
- ⚡ Performance first — OpenLiteSpeed + HTTP/3 + LSCache
- 🔒 Security by default — Auto SSL, FirewallD integration, 2FA, brute-force protection
- 📧 Integrated mail — Postfix, Dovecot, SnappyMail
- 🗂 Backups & restore — One-click snapshots and rollbacks
- 👨💻 Developer friendly — Git manager, REST API, staging, PHP version switcher
Features
Security
- Auto SSL (Let's Encrypt)
- Firewall integrations (FirewallD, optional CSF export)
- 2FA (TOTP + WebAuthn/Passkey)
- AI-powered security scanner (optional)
Hosting & Websites
- OpenLiteSpeed (HTTP/3, QUIC)
- One-click WordPress (LSCache-ready)
- PHP per-site version selector
- File manager, FTP, SFTP
Email & DNS
- Postfix + Dovecot
- SnappyMail webmail
- DNS (PowerDNS) with easy zone management
Developer & Automation
- RESTful API (create/list/manage sites, users, packages)
- Git integration & staging
- Docker command execution support
Backups & Storage
- Local snapshots, remote backups (S3/AWS compatible)
- One-click restore and scheduled backups
Supported platforms (condensed)
| OS family | Recommended / Supported |
|---|---|
| Ubuntu 24.04, 22.04, 20.04 | ✅ Recommended |
| AlmaLinux 10, 9, 8 | ✅ Recommended |
| Debian 13, 12, 11 | ✅ Supported |
| RockyLinux 9, 8 | ✅ Supported |
| RHEL 9, 8 | ✅ Supported |
| CloudLinux 9, 8 | ✅ Supported |
| CentOS 7 | ⚠️ Legacy — EOL |
Architectures: x86_64 (primary), aarch64/ARM64 (supported). AlmaLinux is the recommended RHEL-compatible distribution. Test unsupported OS in staging first.
PHP support (short)
- ✅ Recommended: PHP 8.5 (beta), 8.4, 8.3, 8.2, 8.1
- ⚠️ Legacy: PHP 8.0, PHP 7.4 (security-only)
- ❌ Deprecated: PHP 7.1, 7.2, 7.3 (no longer installed)
Third-party repositories (Remi, Ondrej) may provide older or niche versions; verify compatibility before use.
Quick install
sh <(curl -s https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)
➡️ See guides/INSTALLATION.md for platform-specific options and non-interactive installs.
Upgrade (recommended)
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)
Post-upgrade checklist: verify email, DNS, SSL, and run a smoke test on key sites.
Troubleshooting (common)
Command not found — install curl/wget/git/python3
# Ubuntu/Debian
sudo apt update && sudo apt install -y curl wget git python3
# RHEL/CentOS/Alma/Rocky
sudo yum install -y curl wget git python3
Port 8090 in use — find and stop conflicting process:
sudo ss -tlnp | grep :8090
sudo kill -9 <PID>
Logs & verification
systemctl status lscpd
curl -I http://localhost:8090
tail -f /usr/local/lscp/logs/error.log
journalctl -u lscpd -f
Recent fixes
- 02.02.2026 — Plugin updates: premiumPlugin & paypalPremiumPlugin unified verification (Plugin Grants, activation key, Patreon, PayPal, AES-256-CBC encryption). Installed Plugins UI: bulk activate/deactivate, freshness badges, removed Patreon messaging from front.
- 15.11.2025 — Hardened MySQL password rotation:
mysqlUtilities.changePasswordnow auto-resolves the backing MySQL account (user + host) even whenDBUsersmetadata is missing, preventing the historical[mysqlUtilities.changePassword] can only concatenate str (not "int")error. Regression tests live underTest/mysqlUtilities/, and you should restartlscpdafter deploying the patch so the helper reloads.
Testing
OLS Feature Test Suite
The OpenLiteSpeed feature test suite (128 tests) validates binary integrity, CyberPanel module, Auto-SSL config, SSL listener auto-mapping, .htaccess processing, ReadApacheConf directives, and more.
# Run from CyberPanel repo root
./tests/ols_test_setup.sh # One-time setup
./tests/ols_feature_tests.sh
Requires a live CyberPanel + OLS installation.
Resources
- Official site: https://cyberpanel.net
- Docs (KnowledgeBase): https://cyberpanel.net/KnowledgeBase/
- Community forum: https://community.cyberpanel.net
- GitHub: https://github.com/usmannasir/cyberpanel
- Guides folder: guides (API, INSTALLATION, UPGRADE, TROUBLESHOOTING)
💡 Hosting should be secure, simple, and fast. CyberPanel is built for that.