Troubleshooting

Known problems and fixes for this platform.

Grafana Redirected To localhost

Cause: Grafana root URL/domain did not match the reverse proxy path. Fix: set GF_SERVER_DOMAIN=5.39.37.7, GF_SERVER_ROOT_URL=%(protocol)s://%(domain)s/grafana/ and preserve the path in Nginx.

Nginx 502 Bad Gateway

Cause: backend container is not listening or just restarted. Check docker ps, backend logs and localhost curl.

docker ps
docker logs cloud-dashboard
curl http://127.0.0.1:8080/health

Browser Warns On HTTPS

Expected until a real domain is purchased. The current certificate is self-signed for the IP. Use Let's Encrypt after DNS points to the VPS.

kubeadm Cannot Initialize

Expected on this LXC VPS because br_netfilter and full cgroup/kernel control are unavailable. Use a full Ubuntu VM.

Docs Not Showing

Docs are static files served by Nginx under /docs/. Check Nginx config and files.

ls -l /opt/cloud-platform/docs
nginx -t
systemctl reload nginx
curl http://127.0.0.1/docs/