NetAlertX/docs/WEB_UI_PORT_DEBUG.md

Debugging inaccessible UI

1. Port conflicts

When opening an issue please:

1. Include a screenshot of what you see when accessing HTTP://<your rpi IP>/20211 (or your custom port)
2. Follow steps 1, 2, 3, 4 on this page
3. Execute the following in the container to see the processes and their ports and submit a screenshot of the result:
   1. sudo apk add lsof
   2. sudo lsof -i
4. Try running the nginx command in the container
   1. if you get nginx: [emerg] bind() to 0.0.0.0:20211 failed (98: Address in use) try using a different port number

2. JavaScript issues

Check for browser console (F12 browser dev console) errors + check different browsers.

3. Clear the app cache and cached JavaScript files

Refresh the browser cache (usually shoft + refresh), try a private window, or different browsers. Please also refresh the app cache by clicking the 🔃 (reload) button in the header of the application.

4. Disable proxy

If you have any reverse proxy or similar, try disabling it.

5. Post your docker start details

If you haven't, post your docker compose/run command.

6. Check for errors in your PHP/NGINX error logs

In the container execute:

cat /var/log/nginx/error.log

cat /app/front/log/app.php_errors.log

7. Make sure permissions are correct

Please read the Permissions troubleshooting guide and provide a screesnhot of the permissions and ownership in the /app/db and app/config directories.