mirror of
https://github.com/usmannasir/cyberpanel.git
synced 2025-12-15 21:09:42 +01:00
c679d6ab10
This commit implements per-package resource limits for CyberPanel shared hosting using OpenLiteSpeed's native cgroups v2 integration with automatic server configuration. Features: - 7 new package fields: memoryLimitMB, cpuCores, ioLimitMBPS, inodeLimit, maxConnections, procSoftLimit, procHardLimit - Automatic OLS cgroups setup (no manual server configuration required) - Multi-layer enforcement: OLS config + kernel cgroups v2 + filesystem quotas - Per-user enforcement (subdomains/addon domains share parent's limits) - Graceful degradation if cgroups unavailable - Automatic backup of OLS config before modification Backend Changes: - packages/models.py: Added 7 resource limit fields with defaults - packages/packagesManager.py: CRUD operations for resource limits - plogical/resourceLimits.py: NEW - Resource manager with auto-setup * _ensure_cgroups_enabled(): Automatic OLS cgroups configuration * set_user_limits(): Apply limits via lscgctl * remove_user_limits(): Cleanup on deletion * set_inode_limit(): Filesystem quota management - plogical/vhostConfs.py: Parameterized hardcoded resource limits - plogical/vhost.py: Updated signatures to accept resource limits - plogical/virtualHostUtilities.py: Extract and apply package limits Frontend Changes: - packages/templates/packages/createPackage.html: Resource limits UI - packages/templates/packages/modifyPackage.html: Resource limits UI - packages/static/packages/packages.js: AngularJS controller updates Automatic Setup Flow: When creating a website with enforceDiskLimits=True: 1. Check kernel cgroups v2 support 2. Run lssetup if lscgctl missing 3. Enable cgroups in OLS config if needed 4. Backup and modify /usr/local/lsws/conf/httpd_config.conf 5. Graceful restart of OpenLiteSpeed 6. Apply per-user limits via lscgctl 7. Set inode quotas via setquota Requirements: - Linux kernel 5.2+ (cgroups v2) - OpenLiteSpeed 1.8+ (with lsns support) - quota tools (optional, for inode limits) Backward Compatibility: - Existing packages receive default values via migration - No manual setup required for new installations - Graceful fallback if cgroups unavailable
🛠️ 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:
- 📚 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
🔢 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.shfor 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
- 🌐 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
- 📚 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 |
| 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/