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
