mirror of
https://github.com/usmannasir/cyberpanel.git
synced 2026-02-17 12:06:47 +01:00
207 lines
7.5 KiB
Markdown
207 lines
7.5 KiB
Markdown
<div align="center">
|
|
|
|
<img src="https://community.cyberpanel.net/uploads/default/original/1X/416fdec0e96357d11f7b2756166c61b1aeca5939.png" alt="CyberPanel Logo" width="480"/>
|
|
|
|
# CyberPanel
|
|
|
|
**Web Hosting Control Panel powered by OpenLiteSpeed**
|
|
Fast • Secure • Scalable — Simplify hosting management with style.
|
|
|
|
**Version**: 2.5.5-dev • **Updated**: January 15, 2026
|
|
|
|
[](https://github.com/usmannasir/cyberpanel)
|
|
[](https://cyberpanel.net/KnowledgeBase/)
|
|
[](https://community.cyberpanel.net)
|
|
[](https://discord.gg/g8k8Db3)
|
|
[](https://www.youtube.com/@Cyber-Panel)
|
|
|
|
---
|
|
|
|
</div>
|
|
|
|
## 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 |
|
|
| -------------------------- | ----------------------: |
|
|
| AlmaLinux 10, 9, 8 | ✅ Recommended |
|
|
| CentOS 7 | ⚠️ Legacy — EOL |
|
|
| CloudLinux 9, 8 | ✅ Supported |
|
|
| Debian 13, 12, 11 | ✅ Supported |
|
|
| RHEL 9, 8 | ✅ Supported |
|
|
| RockyLinux 9, 8 | ✅ Supported |
|
|
| Ubuntu 24.04, 22.04, 20.04 | ✅ Recommended |
|
|
|
|
> **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, 8.4
|
|
* ⚠️ **Security fixes only**: PHP 8.3, 8.2, 8.1
|
|
* ❌ **EOL / Deprecated**: PHP 8.0, 7.4, 7.1, 7.2, 7.3 (no longer supported)
|
|
|
|
Third-party repositories may provide older or niche versions; verify compatibility before use. RHEL/Alma/Rocky: [Remi RPM](https://rpms.remirepo.net/). Ubuntu/Debian: [Ondrej PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php). See [php.net/supported-versions](https://www.php.net/supported-versions.php).
|
|
|
|
---
|
|
|
|
## Quick install
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
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.
|
|
|
|
---
|
|
|
|
## Upgrade to v2.5.5-dev (non-interactive)
|
|
|
|
Upgrade to v2.5.5-dev without branch or MariaDB prompts:
|
|
|
|
```bash
|
|
# Upgrade to v2.5.5-dev without prompts
|
|
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh) -b v2.5.5-dev
|
|
|
|
# With MariaDB 10.11 (non-interactive)
|
|
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh) -b v2.5.5-dev --mariadb
|
|
|
|
# Or use --mariadb-version for other versions
|
|
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh) -b v2.5.5-dev --mariadb-version 10.11
|
|
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh) -b v2.5.5-dev --mariadb-version 11.8
|
|
```
|
|
|
|
**Full non-interactive command** (v2.5.5-dev + MariaDB 10.11):
|
|
|
|
```bash
|
|
sh <(curl -s https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/v2.5.5-dev/preUpgrade.sh) -b v2.5.5-dev --mariadb
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting (common)
|
|
|
|
**Command not found** — install curl/wget/git/python3
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
sudo ss -tlnp | grep :8090
|
|
sudo kill -9 <PID>
|
|
```
|
|
|
|
**Logs & verification**
|
|
|
|
```bash
|
|
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.changePassword` now auto-resolves the backing MySQL account (user + host) even when `DBUsers` metadata is missing, preventing the historical `[mysqlUtilities.changePassword] can only concatenate str (not "int")` error. Regression tests live under `Test/mysqlUtilities/`, and you should restart `lscpd` after 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.
|
|
|
|
```bash
|
|
# 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](https://cyberpanel.net)
|
|
* Docs (KnowledgeBase): [https://cyberpanel.net/KnowledgeBase/](https://cyberpanel.net/KnowledgeBase/)
|
|
* Community forum: [https://community.cyberpanel.net](https://community.cyberpanel.net)
|
|
* GitHub: [https://github.com/usmannasir/cyberpanel](https://github.com/usmannasir/cyberpanel)
|
|
* Guides folder: [guides](https://github.com/usmannasir/cyberpanel/blob/stable/guides/INDEX.md) (API, INSTALLATION, UPGRADE, TROUBLESHOOTING)
|
|
|
|
---
|
|
|
|
<div align="center">
|
|
|
|
💡 *Hosting should be secure, simple, and fast. CyberPanel is built for that.*
|
|
|
|
</div>
|