🛠️ 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 Integration with One-Click IP Blocking).
• 📀 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:

• 📚 Complete Guides Index - All available documentation in one place
• 🐳 Docker Command Execution - Execute commands in Docker containers
• 🤖 AI Scanner Setup - Configure AI-powered security scanning
• 📧 Mautic Installation - Email marketing platform setup
• 🎨 Custom CSS Guide - Create custom themes for CyberPanel 2.5.5-dev
• 🛡️ Firewall Blocking Feature - One-click IP blocking from dashboard

---

🔢 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) ⭐ NEW!
• PHP 8.4 - Stable version (EOL: Dec 2027)
• PHP 8.3 - Default version - 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
• Debian 13 - Supported until 2029 ⭐ NEW!
• Debian 12 - Supported until 2027
• Debian 11 - Supported until 2026
• 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:

• 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 (September 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 (September 2025)

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

---

📚 Resources

• 🌐 Official Site
• ✏️ Docs (New)
• 🎓 Docs (Old)
• 📖 Additional Guides - Detailed guides for Docker, AI Scanner, Mautic, and more
• 📚 Local Documentation - All guides available in this repository
• 🤝 Contributing Guide - How to contribute to CyberPanel development
• ✅ Changelog
• 💬 Forums
• 📢 Discord
• 📵 Facebook Group
• 🎥 YouTube Channel

📖 Quick Start Guides

• 🐳 Docker Command Execution - Execute commands in Docker containers
• 🤖 AI Scanner Setup - Configure AI-powered security scanning
• 📧 Mautic Installation - Email marketing platform setup
• 🎨 Custom CSS Guide - Create custom themes for CyberPanel 2.5.5+
• 🛡️ Firewall Blocking Feature - One-click IP blocking from dashboard
• 📚 All Guides Index - Complete documentation hub

🔗 Direct Guide Links

| Feature | Guide | Description | | ------------ | ---------------------------------------------------------- | ---------------------------------- | | 🐳 Docker | Command Execution | Execute commands in containers | | 🤖 Security | AI Scanner | AI-powered security scanning | | 🛡️ Firewall | Firewall Blocking Feature | One-click IP blocking from dashboard | | 📧 Email | Mautic Setup | Email marketing platform | | 🎨 Design | Custom CSS Guide | Create custom themes for 2.5.5-dev | | 📊 Bandwidth | Reset Fix Guide | Fix bandwidth reset issues | | 📚 All | Complete Index | Browse all available guides |

---

🧪 Testing

CyberPanel includes an OLS feature test suite with 128 tests covering all custom OpenLiteSpeed features.

Running Tests

# On the target server, set up test data (once):
bash tests/ols_test_setup.sh

# Run the full 128-test suite:
bash tests/ols_feature_tests.sh

Test Coverage

| Phase | Tests | Coverage | |-------|-------|----------| | Phase 1: Live Environment | 56 | Binary integrity, CyberPanel module, Auto-SSL, LE certificates, SSL listener auto-mapping, cert serving, HTTPS/HTTP, .htaccess processing, VHost config, origin headers, PHP config | | Phase 2: ReadApacheConf | 72 | Include/IncludeOptional, global tuning, listener creation, ProxyPass, IfModule, VHost creation, SSL dedup, Directory/Location blocks, PHP version detection, ScriptAlias, HTTP/HTTPS, process health, graceful restart |

---

🔧 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/