Cyber Panel - The hosting control panel for OpenLiteSpeed
Go to file
Master3395 8131ffe7c7
Merge pull request #1645 from master3395/v2.5.5-dev
Refactor: replace url() with path() for Django routes in plugin Insta…
2026-01-06 19:25:21 +01:00
.github Enhance CyberPanel functionality with FTP Quota and Bandwidth Management features: Added models, views, and templates for managing FTP quotas and bandwidth resets. Implemented IP blocking functionality with associated views and templates. Updated system scripts for improved repository synchronization and OS detection. Removed outdated workflow files. 2025-09-23 21:09:38 +02:00
.idea fix static file permissions 2025-10-01 11:46:58 +05:00
ApachController Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
CLManager Implement ImunifyAV asset management and routing 2025-11-15 23:25:13 +01:00
CLScript v2.4.4 release 2025-09-01 13:11:42 +05:00
CPScripts Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
CyberCP Add plugin system enhancements and testPlugin 2026-01-04 21:04:51 +01: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 enable dark mode 2025-08-05 01:47:22 +05:00
api bug fix: api 2025-09-30 00:12:48 +05:00
backup Implement remote connection handling and progress tracking for backup operations: Introduce a method for attempting connections to remote CyberPanel servers with port fallback. Enhance the frontend to display detailed progress and logs during backup transfers, including error handling and notifications for port fallback usage. Update HTML and JavaScript to support new progress tracking features and improve user feedback during backup and restore processes. 2025-09-20 21:31:41 +02:00
baseTemplate Fix session status logic: Add IDLE state for logged-in users without processes, improve process detection with TTY filtering, enhance status messages with clearer explanations 2026-01-04 03:57:53 +01:00
cli Enhance CyberPanel functionality with FTP Quota and Bandwidth Management features: Added models, views, and templates for managing FTP quotas and bandwidth resets. Implemented IP blocking functionality with associated views and templates. Updated system scripts for improved repository synchronization and OS detection. Removed outdated workflow files. 2025-09-23 21:09:38 +02:00
cloudAPI Implement token generation check in CloudManager and update user token handling in saveChangesAPIAccess. Ensure users are prompted to reset their password if a valid API token is not present when enabling API access. 2025-09-21 19:38:02 +02:00
containerization Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
databases Implement ImunifyAV asset management and routing 2025-11-15 23:25:13 +01:00
dns DNS improvements: CloudFlare proxy toggle styling, auto AAAA records, proxy defaults 2026-01-04 04:15:46 +01:00
dockerManager bug fix: quote errors 2025-09-30 12:31:09 +05: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 Implement .htaccess feature banner and extraction support in file manager 2025-12-17 19:19:00 +01:00
firewall Implement .htaccess feature banner and extraction support in file manager 2025-12-17 19:19:00 +01:00
ftp Enhance text readability and error handling: Add readability fixes CSS for improved contrast across UI elements. Update text colors in various components for better visibility. Enhance FTP error handling with user-friendly messages and improved path validation in both frontend and backend. Update HTML templates to provide clearer instructions and examples for FTP path input. 2025-09-21 22:26:18 +02:00
guides Add PLUGINS.md reference to INDEX.md 2026-01-04 21:29:24 +01:00
highAvailability Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
install Download CDN libraries locally to eliminate tracking prevention warnings. Updated index.html to reference local copies of qrious.min.js and chart.umd.min.js. Added functionality in install.py and upgrade.py to download these libraries before running collectstatic. Updated website.html to ensure compatibility with the new local scripts. 2026-01-01 05:29:46 +01:00
locale Add Norwegian Bokmål language. 2025-09-08 16:48:38 +02:00
loginSystem find was deleting important env files 2025-10-01 01:28:40 +05:00
mailServer Implement Catch-All Email Configuration Management 2025-12-31 22:18:33 +01:00
managePHP Refactor configuration modification methods for improved safety and validation 2025-12-31 23:13:53 +01:00
manageSSL debian 12: add missing views to views.py in websitefunctions 2025-09-19 15:04:25 +05:00
manageServices Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
modules Implement ImunifyAV asset management and routing 2025-11-15 23:25:13 +01:00
packages Add cosmetic context processor and update templates for custom CSS 2025-09-13 18:38:57 +02:00
plogical Fix: Enable website creation for regular users 2026-01-04 22:03:27 +01:00
pluginHolder Refactor: replace url() with path() for Django routes in plugin Installer 2026-01-06 19:23:04 +01:00
pluginInstaller Add plugin system enhancements and testPlugin 2026-01-04 21:04:51 +01: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
serverLogs Fix ALL documentation links. 2025-09-08 11:50:35 +02:00
serverStatus Add functionality to switch back to OpenLiteSpeed: Implement server status utility methods, views, and frontend controller for switching from LiteSpeed Enterprise to OpenLiteSpeed. Include status checking and user notifications during the switch process, enhancing user experience and management capabilities. 2025-09-21 00:27:49 +02:00
skin_customizations Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
static Implement .htaccess feature banner and extraction support in file manager 2025-12-17 19:19:00 +01:00
testPlugin Add plugin system enhancements and testPlugin 2026-01-04 21:04:51 +01:00
tuning Add Almalinux 10 and php 84+85 2025-09-07 22:57:53 +02:00
userManagment Add regenerateTwoFASecret functionality and UI support 2025-10-17 01:06:04 +02:00
websiteFunctions Download CDN libraries locally to eliminate tracking prevention warnings. Updated index.html to reference local copies of qrious.min.js and chart.umd.min.js. Added functionality in install.py and upgrade.py to download these libraries before running collectstatic. Updated website.html to ensure compatibility with the new local scripts. 2026-01-01 05:29:46 +01:00
.DS_Store Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
.gitignore Update .gitignore and remove test files: Add patterns for development test files to .gitignore and delete unused test.php and test.sh files to clean up the repository. 2025-09-20 20:13:21 +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
INSTALLER_SUMMARY.md Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
LICENSE Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
README.md Update README and mysqlUtilities for versioning and MySQL account resolution 2025-11-15 23:55:47 +01:00
UNIVERSAL_OS_COMPATIBILITY.md Add comprehensive OS compatibility features and testing scripts 2025-09-25 09:35:42 +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 Refactor CyberPanel installation logic to streamline PHP version handling 2025-10-16 22:34:18 +02:00
cyberpanel_clean.sh Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
cyberpanel_complete.sh Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
cyberpanel_simple.sh Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
cyberpanel_standalone.sh Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02:00
cyberpanel_upgrade.sh Update repository URLs to use secure HTTPS links 2025-09-25 22:45:35 +02:00
cyberpanel_utility.sh Implement dynamic PHP version detection and configuration updates 2025-12-17 19:48:28 +01:00
deploy_phpmyadmin_redirect.sh Add PhpMyAdmin access middleware and session check for user authentication 2025-09-15 01:39:21 +02: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_installation_issues.sh Add enhanced installation and service status scripts 2025-09-25 11:21:00 +02:00
index.html Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
install.sh Enhance CyberPanel installation process with user-friendly progress indicators 2025-09-25 13:26:42 +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
package-lock.json bug fix: staging site issue 2025-09-27 11:41:16 +05:00
phpmyadmin.zip Initial commit for v2.4.3 2025-08-01 14:56:30 +05:00
phpmyadmin_htaccess Add PhpMyAdmin access middleware and session check for user authentication 2025-09-15 01:39:21 +02:00
phpmyadmin_index_redirect.php Add PhpMyAdmin access middleware and session check for user authentication 2025-09-15 01:39:21 +02:00
preUpgrade.sh Enhance branch detection and installation process in scripts: Updated cyberpanel.sh to improve branch/version detection logic based on execution context. Modified install.sh to allow installation from a specified branch and adjusted preUpgrade.sh to support branch parameter for upgrades. Improved error handling and logging for better user feedback. 2025-09-23 21:50:37 +02:00
requirements-secure.txt Security: Update Python packages to fix critical vulnerabilities 2026-01-04 22:22:48 +01:00
requirments-old.txt Fix pysftp dependency issue and optimize WSGI-LSAPI compilation: Removed pysftp from requirements in favor of paramiko, and updated Makefile for proper optimization flags to avoid _FORTIFY_SOURCE warnings during WSGI-LSAPI installation. 2025-09-23 19:06:33 +02:00
requirments.txt Security: Update Python packages to fix critical vulnerabilities 2026-01-04 22:22:48 +01:00
rollback_phpmyadmin_redirect.sh Add PhpMyAdmin access middleware and session check for user authentication 2025-09-15 01:39:21 +02:00
service_status_check.sh Add enhanced installation and service status scripts 2025-09-25 11:21:00 +02:00
simple_install.sh Revert "Enhance OS detection and support for AlmaLinux 10 and additional Ubun…" 2025-10-09 23:05:16 +02: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
validate_installation.sh Add comprehensive OS compatibility features and testing scripts 2025-09-25 09:35:42 +02:00
version.txt Remove deprecated migration script and update version to 2.4 Build 4: The `run_migration.py` script has been deleted as it is no longer needed. The version file has been incremented to reflect the latest build. Additionally, the Django settings have been updated to include `DEFAULT_AUTO_FIELD` for improved primary key handling. 2025-09-23 09:55:27 +02:00

README.md

CyberPanel Logo

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

GitHub Docs Forum Discord YouTube


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
Debian 13, 12, 11 Supported
AlmaLinux 10, 9, 8 Supported
RockyLinux 9, 8 Supported
RHEL 9, 8 Supported
CloudLinux 9, 8 Supported
CentOS 7 ⚠️ Legacy — EOL

CyberPanel targets x86_64 only. Test the 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.


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

  • 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.

Resources


💡 Hosting should be secure, simple, and fast. CyberPanel is built for that.