Troubleshooting

Fixes for the most common problems. If your issue is not here, hop in the Discord and ask (link in the dashboard’s Help menu).

I get “502 Bad Gateway” when opening the dashboard

The Node service is not running.

sudo systemctl status nexora-dashboard
sudo journalctl -u nexora-dashboard -f

Read the log for the actual error. Most common causes:

Database connection refused: wrong DB_HOST or DB_PORT in .env, or your DB does not allow remote connections.
Port already in use: change PORT in .env and update proxy_pass in nginx.
Missing files: the release ZIP was not fully extracted. Re-extract and run npm ci --omit=dev again.

SSL certificate failed during install

Your domain DNS is not pointing at this server.

dig +short yourdomain.com

The IP must match your server’s public IP. Fix DNS, wait 5 minutes, then retry:

sudo certbot --nginx -d yourdomain.com

Dashboard loads but shows no live data

The Lua resource is not connected.

In your FiveM server console, run ensure nexora-dashboard. Watch for [nexora-dashboard] errors.
Check DASHBOARD_API_KEY convar in server.cfg matches FIVEM_API_KEY in /home/fivem/.env.
Check DASHBOARD_URL convar is reachable from the FiveM server. Test with curl https://yourdomain.com/api/health.
If the FiveM server is behind a firewall, allow outbound 443.

Typo in username or password.
If you have Discord OAuth set up, try that path instead.
Locked out completely? See below.

I forgot my admin password

Reset it via the database. SSH in and run:

mysql -u <DB_USER> -p <DB_NAME>

Then in the MySQL prompt:

UPDATE dash_users
SET password_hash = '$2b$10$replace_with_a_fresh_bcrypt_hash'
WHERE username = 'your-username';

Generate a bcrypt hash:

node -e "console.log(require('bcrypt').hashSync('your-new-password', 10))"

(Run from /home/fivem so bcrypt is found.)

WebSocket disconnects, live data freezes

Your nginx config is missing the WebSocket headers. Make sure the config has:

location /nui-ws {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_read_timeout 86400;
}

Reload nginx after fixing: sudo nginx -t && sudo systemctl reload nginx.

SSL will not renew

Certbot’s cron should auto-renew. Force a renewal test:

sudo certbot renew --dry-run

Common cause: nginx config got edited and now has invalid syntax. Run sudo nginx -t and fix what it reports.

”Cannot find module ‘dist/server/index.js’”

The release ZIP is incomplete or you replaced dist/ with something. Re-extract the original ZIP into /home/fivem, run npm ci --omit=dev, then:

sudo systemctl restart nexora-dashboard

Service keeps restarting

Likely a startup crash in a loop. Watch the log:

sudo journalctl -u nexora-dashboard -f

If the same error appears every 5 seconds, it is a config problem (usually DB). Fix .env, then restart.

Player screen streaming is laggy or black

Player has slow upload bandwidth.
Player’s CEF is throttled. Ask them to set set ui_alwaysHardwareCursor true in their FiveM config and restart.
Server is dropping the WebSocket because nginx timeouts are too short. Confirm proxy_read_timeout 86400 is set.

A new version broke something

Roll back to the previous release ZIP from your Tebex purchase page.

sudo systemctl stop nexora-dashboard
cd /home
sudo rm -rf fivem
sudo unzip /path/to/previous-nexora-dashboard-v*.zip
sudo mv nexora-dashboard-v* fivem
cd fivem
sudo cp /root/.env.backup .env   # restore your saved .env
sudo npm ci --omit=dev
sudo systemctl start nexora-dashboard

Then report the bug on Discord with the version that broke and the journalctl output.

Tip: keep a copy of /home/fivem/.env somewhere safe (e.g. /root/.env.backup). Re-extracting overwrites the folder.

Welcome

Getting Started

Lua Resource

Dashboard Pages

Help

I get “502 Bad Gateway” when opening the dashboard

SSL certificate failed during install

Dashboard loads but shows no live data

I forgot my admin password

WebSocket disconnects, live data freezes

SSL will not renew

”Cannot find module ‘dist/server/index.js’”

Service keeps restarting

Player screen streaming is laggy or black

A new version broke something

​I get “502 Bad Gateway” when opening the dashboard

​SSL certificate failed during install

​Dashboard loads but shows no live data

​Login fails with “invalid credentials”

​I forgot my admin password

​WebSocket disconnects, live data freezes

​SSL will not renew

​”Cannot find module ‘dist/server/index.js’”

​Service keeps restarting

​Player screen streaming is laggy or black

​A new version broke something

I get “502 Bad Gateway” when opening the dashboard

SSL certificate failed during install

Dashboard loads but shows no live data

Login fails with “invalid credentials”

I forgot my admin password

WebSocket disconnects, live data freezes

SSL will not renew

”Cannot find module ‘dist/server/index.js’”

Service keeps restarting

Player screen streaming is laggy or black

A new version broke something