Requirements
Operating System
Ubuntu 20 or 22 or 24
Debian 11 or 12
Almalinux 8 or 9
CentOS Stream 8 or 9
Rocky Linux 8 or 9

Step 1: Connect to your server via SSH
The installation of OLSPanel is quite simple. First, log into your server via SSH as the root user (sudo will not work). You can get the login details from your web host.

Step 2: Run the installation script
Run the following command.
apt update && apt -y upgrade && apt -y install curl wget sudo

Step 3: Run the installation script
bash <(curl -fsSL https://olspanel.com/install.sh || wget -qO- https://olspanel.com/install.sh)

Step 4: Installation
The installation process will proceed automatically. It will take 5-10 minutes, depending on the speed of your server.

Step 5: Finalize Installation
At the end of the installation process, you will be presented with the following screen which contains important information about your configuation. Select and copy it to a safe location for future reference.

Login url: https://<your server's IP address>:port Panel username: admin Panel password: xxxxxxxxxxxx

Step 6: Restart Server
Would you like to restart your server :

Enter “reboot” later after you have performed other desired operations.

Step 7: Access OLSPanel
After the successful installation you can access OLSPanel using the details below (make sure to change):

URL: https://<Your Server's IP Address>:<port>
Username: admin
Password: xxxxxxxxxxx

Troubleshooting
503 Error After Install
If you get a 503 error after installing OLSPanel, you can do one of the following things.

1. Check panel service Status.

systemctl status cp

If cp is not running, start cp using:

systemctl start cp

2. Manually set up virtualenv

source /root/venv/bin/activate
pip install --ignore-installed -r requirments.txt
deactivate
systemctl restart cp