Cyber Panel - The hosting control panel for OpenLiteSpeed
Go to file
usmannasir f7fc75b258 Add binary verification and rollback mechanism for OLS custom binaries
Implement safety checks to verify custom OpenLiteSpeed binaries work before committing to them:

Verification checks:
- Check library dependencies with ldd to detect missing libraries
- Test binary execution with -v flag to ensure it can run
- Detect issues like wrong binary type (ubuntu vs rhel) for the OS

Rollback mechanism:
- Automatically restore original binary from backup if verification fails
- Remove incompatible custom module
- Continue installation with standard OLS if custom binary fails

This prevents installation failures and system downtime when:
- Wrong binary type is downloaded due to OS detection issues
- Library dependencies are missing
- Binary cannot execute on the target system

Changes:
- Added verifyCustomBinary() method to check dependencies and execution
- Added rollbackCustomBinary() method to restore from backup
- Updated installCustomOLSBinaries() to verify and rollback on failure
- Applied to both install/installCyberPanel.py and plogical/upgrade.py

Benefits:
- Zero downtime: System falls back to working binary automatically
- Better error reporting: Shows which libraries are missing
- Safer upgrades: Users won't be left with broken installations
2025-11-07 13:50:47 +05:00
.github Update sync2gitee.yml 2021-11-13 21:20:34 +01:00
.idea bug fix: allowed host issue 2025-09-15 11:26:58 +05:00
ApachController Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
CLManager v2.4.3 2025-08-04 00:03:02 +05:00
CLScript v2.4.4 release 2025-09-01 13:11:42 +05:00
CPScripts Fix mirror gettoforge 2025-09-12 09:42:52 +02:00
CyberCP Fix security middleware to allow file content in API endpoints 2025-10-26 15:08:34 +05:00
IncBackups Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
WebTerminal Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
aiScanner Increase rate limits for bulk fix operations from platform 2025-10-28 12:37:12 +05:00
api Fix CyberPanel API key validation for platform callbacks 2025-10-27 13:51:33 +05:00
backup Add storage stats, last backup info, and error logs to ManageOCBackups page 2025-10-14 19:11:38 +05:00
baseTemplate Add appealing notification banner for .htaccess feature 2025-11-06 20:46:10 +05:00
cli Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
cloudAPI v2.4.3 2025-08-04 00:03:02 +05:00
containerization Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
databases bug fix: font issues 2025-08-29 23:07:30 +05:00
dns Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
dockerManager Add pull image functionality and enhance error handling 2025-09-12 22:35:02 +02:00
emailMarketing Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
emailPremium Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
examplePlugin Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
filemanager Fix permission race condition in fixPermissions function 2025-10-16 16:11:28 +05:00
firewall Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
ftp bug fix: font issues 2025-08-29 23:07:30 +05:00
guides Add contributing guide link to README and improve security notice in SECURITY_INSTALLATION.md 2025-09-13 22:34:03 +02:00
highAvailability Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
install Add binary verification and rollback mechanism for OLS custom binaries 2025-11-07 13:50:47 +05:00
locale Add Norwegian Bokmål language. 2025-09-08 16:48:38 +02:00
loginSystem bug fix: login issues 2025-09-04 13:03:10 +05:00
mailServer Add cosmetic context processor and update templates for custom CSS 2025-09-13 18:38:57 +02:00
managePHP Add Almalinux 10 and php 84+85 2025-09-07 22:57:53 +02:00
manageSSL Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
manageServices Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
packages Add cosmetic context processor and update templates for custom CSS 2025-09-13 18:38:57 +02:00
plogical Add binary verification and rollback mechanism for OLS custom binaries 2025-11-07 13:50:47 +05:00
pluginHolder services 2025-08-05 03:04:38 +05:00
pluginInstaller Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
postfixSenderPolicy Fix monthly bandwidth for websites 2025-09-12 10:41:11 +02:00
s3Backups Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
scripts Fix monthly bandwidth for websites 2025-09-12 10:41:11 +02:00
serverLogs Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
serverStatus Add cosmetic context processor and update templates for custom CSS 2025-09-13 18:38:57 +02:00
skin_customizations Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
static Update backup controller to include backup frequency and retention data 2025-09-13 17:36:50 +02:00
testPlugin Enhance security by adding rel="noopener" to external links 2025-09-13 17:44:37 +02:00
to-do Enhance environment variable management and security 2025-09-13 19:07:03 +02:00
tuning Add Almalinux 10 and php 84+85 2025-09-07 22:57:53 +02:00
userManagment bug fix: font issues 2025-08-29 23:07:30 +05:00
websiteFunctions fix some ux on list wp sites 2025-10-13 13:09:06 +05:00
.DS_Store Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
.env.template bug fix: allowed host issue 2025-09-15 12:07:15 +05:00
.gitignore Enhance environment variable management and security 2025-09-13 19:07:03 +02:00
AllCPUbuntu.json Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
CONTRIBUTING.md Add contributing guide link to README and improve security notice in SECURITY_INSTALLATION.md 2025-09-13 22:34:03 +02:00
CPCent7repo.json Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
FetchIP.sh Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
LICENSE Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
ModuleDeveloperGuide.pdf Add OpenLiteSpeed Module Developer Guide documentation 2025-10-28 12:39:27 +05:00
README.md Add contributing guide link to README and improve security notice in SECURITY_INSTALLATION.md 2025-09-13 22:34:03 +02:00
SECURITY_INSTALLATION.md Add contributing guide link to README and improve security notice in SECURITY_INSTALLATION.md 2025-09-13 22:34:03 +02:00
cert.pem Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
cyberpanel.min.js Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
cyberpanel.sh Fix monthly bandwidth for websites 2025-09-12 10:41:11 +02:00
cyberpanel_upgrade.sh Fix monthly bandwidth for websites 2025-09-12 10:41:11 +02:00
cyberpanel_utility.sh Add Almalinux 10 and php 84+85 2025-09-07 22:57:53 +02:00
faq.sh Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
fastapi_ssh_server.py Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
fastapi_ssh_server.service Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
fix_cyberpanel_install.sh v2.4.3 2025-08-04 00:03:02 +05:00
index.html Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
install.sh Add Almalinux 10 and php 84+85 2025-09-07 22:57:53 +02:00
key.pem Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
langcomp.sh Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
lscpd-0.2.7 Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
lscpd-0.3.1 Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
lscpd.0.4.0 Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
lscpd.aarch64 Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
manage.py Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
phpmyadmin.zip Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
preUpgrade.sh Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
requirments-old.txt bug fix: python 3.6 compatibility 2025-10-10 17:59:01 +05:00
requirments.txt Enhance environment variable management and security 2025-09-13 19:07:03 +02:00
test.php Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
test.sh Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
test_api_auth.py Add X-API-Key header support for AI Scanner file operations 2025-10-27 13:29:30 +05:00
test_api_key_fix.sh Fix backup file operation failures for API key authentication 2025-10-27 14:16:01 +05:00
ubuntu-requirments.txt Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
upgrade.sh Remove CSF support as it's being discontinued on August 31, 2025 2025-08-11 15:49:31 +05:00
version.txt v2.4.3 2025-08-04 00:03:02 +05:00

README.md

🛠️ CyberPanel

Web Hosting Control Panel powered by OpenLiteSpeed, designed to simplify hosting management.


🔧 Features & Services

  • 🔐 Different User Access Levels (via ACLs).
  • 🌌 Auto SSL for secure websites.
  • 💻 FTP Server for file transfers.
  • 🕒 Light-weight DNS Server (PowerDNS).
  • 🔐 phpMyAdmin to manage databases (MariaDB).
  • 📧 Email Support (SnappyMail).
  • 🕌 File Manager for quick file access.
  • 🌐 PHP Management made easy.
  • 🔒 Firewall (FirewallD & ConfigServer Firewall Integration).
  • 📀 One-click Backups and Restores.
  • 🐳 Docker Management with command execution capabilities.
  • 🤖 AI-Powered Security Scanner for enhanced protection.
  • 📊 Monthly Bandwidth Reset - Automatic bandwidth usage reset (Fixed in latest version).

📖 Documentation & Guides

CyberPanel comes with comprehensive documentation and step-by-step guides:


🔢 Supported PHP Versions

CyberPanel supports a wide range of PHP versions across different operating systems:

☑️ Currently Supported PHP Versions

  • PHP 8.5 - Latest stable version (EOL: Dec 2028)
  • PHP 8.4 - Stable version (EOL: Dec 2027)
  • PHP 8.3 - Stable version (EOL: Dec 2027)
  • PHP 8.2 - Stable version (EOL: Dec 2026)
  • PHP 8.1 - Stable version (EOL: Dec 2025)
  • PHP 8.0 - Legacy support (EOL: Nov 2023)
  • PHP 7.4 - Legacy support (EOL: Nov 2022)

🔧 Third-Party PHP Add-ons

For additional PHP versions or specific requirements, you can install third-party packages:

Ubuntu/Debian

  • Ondrej's PPA: Provides PHP 5.6 to 8.5
  • Sury's PPA: Alternative repository with latest PHP versions

RHEL-based Systems (AlmaLinux, RockyLinux, CentOS, RHEL)

  • Remi Repository: Comprehensive PHP package collection
  • EPEL Repository: Additional packages for enterprise Linux

CloudLinux

  • CloudLinux PHP Selector: Built-in tool for managing multiple PHP versions
  • Remi Repository: Additional PHP versions and extensions

Note: Third-party repositories may provide additional PHP versions beyond what's available in default repositories. Always verify compatibility with your specific use case.


🌐 Supported Operating Systems

CyberPanel runs on x86_64 architecture and supports the following operating systems:

Currently Supported

  • Ubuntu 24.04.3 - Supported until April 2029 NEW!
  • Ubuntu 22.04 - Supported until April 2027
  • Ubuntu 20.04 - Supported until April 2025
  • AlmaLinux 10 - Supported until May 2030 NEW!
  • AlmaLinux 9 - Supported until May 2032
  • AlmaLinux 8 - Supported until May 2029
  • RockyLinux 9 - Supported until May 2032
  • RockyLinux 8 - Supported until May 2029
  • RHEL 9 - Supported until May 2032
  • RHEL 8 - Supported until May 2029
  • CloudLinux 8 - Supported until May 2029
  • CentOS 9 - Supported until May 2027

🔧 Third-Party OS Support

Additional operating systems may be supported through third-party repositories or community efforts:

  • Debian - May work with Ubuntu-compatible packages
  • openEuler - Community-supported with limited testing
  • Other RHEL derivatives - May work with AlmaLinux/RockyLinux packages

Note: For unsupported operating systems, compatibility is not guaranteed. Always test in a non-production environment first.


⚙️ Installation Instructions

Install CyberPanel easily with the following command:

sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

📊 Upgrading CyberPanel

Upgrade your CyberPanel installation using:

sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)

🆕 Recent Updates & Fixes

Bandwidth Reset Issue Fixed (January 2025)

  • Issue: Monthly bandwidth usage was not resetting, causing cumulative values to grow indefinitely
  • Solution: Implemented automatic monthly bandwidth reset for all websites and child domains
  • Affected OS: All supported operating systems (Ubuntu, AlmaLinux, RockyLinux, RHEL, CloudLinux, CentOS)
  • Manual Reset: Use /usr/local/CyberCP/scripts/reset_bandwidth.sh for immediate reset
  • Documentation: See Bandwidth Reset Fix Guide

New Operating System Support Added (January 2025)

  • Ubuntu 24.04.3: Full compatibility with latest Ubuntu LTS
  • AlmaLinux 10: Full compatibility with latest AlmaLinux release
  • Long-term Support: Both supported until 2029-2030

📚 Resources

📖 Quick Start Guides

Feature Guide Description
🐳 Docker Command Execution Execute commands in containers
🤖 Security AI Scanner AI-powered security scanning
📧 Email Mautic Setup Email marketing platform
📊 Bandwidth Reset Fix Guide Fix bandwidth reset issues
📚 All Complete Index Browse all available guides

🔧 Troubleshooting

Common Issues & Solutions

Bandwidth Not Resetting Monthly

  • Issue: Bandwidth usage shows cumulative values instead of monthly usage
  • Solution: Run the bandwidth reset script: /usr/local/CyberCP/scripts/reset_bandwidth.sh
  • Prevention: Ensure monthly cron job is running: 0 0 1 * * /usr/local/CyberCP/bin/python /usr/local/CyberCP/postfixSenderPolicy/client.py monthlyCleanup

General Support

  • Check logs: /usr/local/lscp/logs/error.log
  • Verify cron jobs: crontab -l
  • Test manual reset: Use provided scripts in /usr/local/CyberCP/scripts/