Overview of Deploying CyberPanel on Server¶

Prerequisites and Basic Requirements¶

A clean, supported operating system installation.
Ubuntu 22.04 LTS or any Debian‑based distro (tested on Ubuntu 22).
CentOS 8 / Rocky Linux 8 (the RHEL 8 stream) for RHEL family users.
Root or sudo‑privileged account to run the installation script.
A public domain name that can be pointed to the server’s IP address.
The domain should be resolvable via DNS A record to the server IP before starting the deployment.
An SSH password or key‑based access to the server for the initial run.

The installation procedure automatically updates the package cache, downloads the CyberPanel installer, and configures the installation in silent mode.

Installation Process¶

On Ubuntu 22.04 (Debian)¶

The package list is refreshed with apt update.
The installer script is downloaded from the CyberPanel official mirror and saved as /root/cyberpanel.sh.
The script is modified to run in silent mode and to use the SSH password as the CyberPanel admin password.
The common name and hostname are replaced with a fully‑qualified domain derived from variables (prefix, server_id, and zone).
The script is executed twice to ensure all components are installed correctly.
The system is rebooted to finalize configuration.

On CentOS 8 / Rocky Linux 8 (RHEL)¶

All packages are updated with yum.
The installer script for Rocky 8 is downloaded to /root/cyberpanel.sh.
The same silent‑mode and password settings are applied.
Hostname adjustments mirror the Debian process.
The script is executed twice; a reboot follows.

The script is run as root; the installed files are placed by the script in the default system directories used by CyberPanel.

Access Rights and Security¶

The CyberPanel administrative interface is secured with the password set during installation (ansible_ssh_pass).
The script runs as the root user, but after installation, the primary management interface is accessed via HTTPS on port 8443 (default for CyberPanel).
The installation replaces any existing hostname or common name entries, ensuring the server’s TLS certificates match the provided domain.

Permission Settings¶

The installer sets /root/cyberpanel.sh to executable (0755).
File permissions for the rest of the CyberPanel installation are set by the installer itself and are not altered by the playbook.

Starting, Stopping, and Updating¶

Starting: After reboot, the CyberPanel service starts automatically. Access the dashboard at https://<your‑domain>:8443.
Stopping:
```
systemctl stop cyberpanel
```
Restarting:
```
systemctl restart cyberpanel
```
Updating:
The recommended way to update CyberPanel is to run the official update script that ships with the installation or to execute cyberpanel -u from the command line. This process pulls the latest package and applies updates without needing to reinstall.

No Docker containers, proxy servers, or external databases are configured by default in this deployment process. All components are installed directly on the host operating system.