Fix CyberPanel 503 errors on your VPS

CyberPanel may show a 503 Service Unavailable error if OpenLiteSpeed is down, required ports are blocked, or the server runs out of memory. This guide walks you through the most reliable fixes.

Quick fix for low RAM

Many 503 errors occur when OpenLiteSpeed crashes due to insufficient memory. Create a 2 GB swap file and restart services:

fallocate -l 2G /swapfile \
    chmod 600 /swapfile \
    mkswap /swapfile \
    swapon /swapfile \
    echo '/swapfile none swap sw 0 0' >> /etc/fstab \
    systemctl restart lsws lscpd

Then open:

https://SERVER_IP:8090

Step 1 — Check services

Verify OpenLiteSpeed and CyberPanel services:

systemctl status lsws lscpd --no-pager 
systemctl restart lsws lscpd

Step 2 — Verify listening ports

Check that CyberPanel and OpenLiteSpeed admin ports are listening:

ss -lntp | grep -E ':(8090|7080)'

You should see LISTEN entries on port 8090 (CyberPanel) and 7080 (OpenLiteSpeed admin).

Step 3 — Open firewall ports

Ubuntu (UFW):

Allow port 8090
Allow port 7080
Allow HTTP and HTTPS

ufw allow 8090/tcp 
ufw allow 7080/tcp 
ufw allow 80,443/tcp

AlmaLinux/Rocky (firewalld):

firewall-cmd --permanent --add-port=8090/tcp \
    firewall-cmd --permanent --add-port=7080/tcp \
    firewall-cmd --permanent --add-service=http \
    firewall-cmd --permanent --add-service=https \
    firewall-cmd --reload

Step 4 — Access CyberPanel directly

If you use Cloudflare or another proxy, bypass it to test the origin server:

https://SERVER_IP:8090 https://SERVER_IP:7080

Step 5 — Check logs

Look for errors from OpenLiteSpeed or CyberPanel:

tail -n 200 /usr/local/lsws/logs/error.log \
    tail -n 200 /var/log/cyberpanel/error.log \
    journalctl -u lsws -u lscpd -n 200 --no-pager

Step 6 — Check for out-of-memory kills

free -h dmesg | grep -i -E 'out of memory|killed process' | tail -n 10

If memory is low, add swap (see Quick fix section).

Step 7 — Check SELinux (Alma/Rocky)

getenforce \
    setenforce 0 \
    sed -i 's/^SELINUX=enforcing/SELINUX=permissive/' /etc/selinux/config \
    systemctl restart lsws lscpd

If CyberPanel works after this, SELinux was blocking processes.

Step 8 — Check for port conflicts

lsof -i :8090 -Pn

If another application is using port 8090, stop or reconfigure it.

Step 9 — Verify OpenLiteSpeed listeners

Open:

https://SERVER_IP:7080

Navigate to Listeners and confirm that *:8090 exists, then restart:

systemctl restart lsws

Step 10 — Repair CyberPanel

Update the OS, then run the CyberPanel installer’s repair option:

apt update && apt -y upgrade || dnf -y update

sh <(curl -s https://cyberpanel.net/install.sh)

Select the repair/upgrade option when prompted.

After it works

You should now be able to access:

CyberPanel: https://SERVER_IP:8090
OpenLiteSpeed Admin: https://SERVER_IP:7080

Check that ports 80 and 443 are open if you plan to host websites with SSL.

A stable CyberPanel setup works best with at least 2 GB RAM + 2 GB swap. Remember that LumaDock VPS are unmanaged, which means OS, firewalls, and control panels are fully user-managed.