[GH-ISSUE #1394] WebSocket self-check fails #3880

New issue

Closed

opened 2026-02-28 11:58:08 +03:00 by kerem · 1 comment

kerem commented

2026-02-28 11:58:08 +03:00

Owner

Originally created by @ntdgo on GitHub (Oct 15, 2025).
Original GitHub issue: https://github.com/0xJacky/nginx-ui/issues/1394

Describe the bug
After installing Nginx UI on Ubuntu 24.04, the Self Check page reports:

Self check failed, Nginx UI may not work properly
with the WebSocket item failing. All other checks (nginx paths, logs, conf dirs, etc.) pass.

To Reproduce
Install Nginx-UI:

curl -L https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh | sudo bash -s install
sudo apt update
sudo apt install nginx -y
sudo systemctl restart nginx-ui
sudo ufw allow 80
sudo ufw allow 443
sudo ufw allow "Nginx Full"

Site Config

server {
    listen 80;
    listen [::]:80;
    server_name nginx.mysite.pro;
    return 301 https://$host$request_uri;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name nginx.mysite.pro;
    ssl_certificate /etc/nginx/ssl/*.mysite.pro_mysite.pro_P256/fullchain.cer;
    ssl_certificate_key /etc/nginx/ssl/*.mysite.pro_mysite.pro_P256/private.key;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

Screenshots

Info (please complete the following information):

Server OS: [e.g. Ubuntu 22.04]
Server Arch: [e.g. x86, aach64]
Nginx UI Version: 2.2.0 (502)
Your Browser: Edge

Additional context

I originally installed Nginx UI about 4 months ago, and the WebSocket issue appeared a few days after installation.
After around 3 months, my SSL certificate stopped renewing automatically. I tried renewing it manually, but it failed.
To fix that, I fully uninstalled both Nginx and Nginx UI, then reinstalled everything from scratch.

At first, everything worked correctly — SSL generation, site configuration, etc..
However, after a few days, the WebSocket error appeared again on the Self Check page.

It seems this issue might build up or appear over time rather than immediately after installation.

Originally created by @ntdgo on GitHub (Oct 15, 2025). Original GitHub issue: https://github.com/0xJacky/nginx-ui/issues/1394 **Describe the bug** After installing **Nginx UI** on **Ubuntu 24.04**, the **Self Check** page reports: > **Self check failed, Nginx UI may not work properly** > with the **WebSocket** item failing. All other checks (nginx paths, logs, conf dirs, etc.) pass. **To Reproduce** Install Nginx-UI: ```cmd curl -L https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh | sudo bash -s install sudo apt update sudo apt install nginx -y sudo systemctl restart nginx-ui sudo ufw allow 80 sudo ufw allow 443 sudo ufw allow "Nginx Full" ``` Site Config ```cmd server { listen 80; listen [::]:80; server_name nginx.mysite.pro; return 301 https://$host$request_uri; location / { proxy_pass http://127.0.0.1:9000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $remote_addr; } } server { listen 443 ssl; listen [::]:443 ssl; server_name nginx.mysite.pro; ssl_certificate /etc/nginx/ssl/*.mysite.pro_mysite.pro_P256/fullchain.cer; ssl_certificate_key /etc/nginx/ssl/*.mysite.pro_mysite.pro_P256/private.key; location / { proxy_pass http://127.0.0.1:9000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $remote_addr; } } ``` **Screenshots** <img width="2280" height="1304" alt="Image" src="https://github.com/user-attachments/assets/2f9adc52-61eb-4ac2-9cc9-12525dcec188" /> **Info (please complete the following information):** - Server OS: [e.g. Ubuntu 22.04] - Server Arch: [e.g. x86, aach64] - Nginx UI Version: 2.2.0 (502) - Your Browser: Edge ## Additional context I originally installed Nginx UI about **4 months ago**, and the **WebSocket issue appeared a few days after installation**. After around 3 months, **my SSL certificate stopped renewing automatically**. I tried renewing it manually, but it failed. To fix that, I **fully uninstalled both Nginx and Nginx UI**, then **reinstalled** everything from scratch. At first, everything worked correctly — **SSL generation, site configuration, etc.**. However, **after a few days**, the **WebSocket error appeared again** on the **Self Check** page. It seems this issue might build up or appear over time rather than immediately after installation.

kerem

2026-02-28 11:58:08 +03:00

closed this issue
added the
bug
label

kerem commented

2026-02-28 11:58:09 +03:00

Author

Owner

@0xJacky commented on GitHub (Oct 15, 2025):

Please make sure that your reverse proxy configuration supports websocket: https://nginxui.com/guide/nginx-proxy-example.html

@0xJacky commented on GitHub (Oct 15, 2025): Please make sure that your reverse proxy configuration supports websocket: https://nginxui.com/guide/nginx-proxy-example.html