Skip to main content
Skip this page if you used the auto install. Use this if you want full control or already have nginx configured.

1. Install dependencies

Debian / Ubuntu:
Verify:

2. Extract the release ZIP

Upload nexora-dashboard-vX.X.X.zip to the server, then:
The release already contains dist/server/ and dist/client/. You do not need to build anything.

3. Create .env

Copy the example and edit it:
See Environment variables for what every field means. At minimum fill in JWT_SECRET, FIVEM_API_KEY, and all DB_* values. Generate strong secrets:
Lock down permissions:

4. nginx config

Create /etc/nginx/sites-available/nexora-dashboard:
Replace dash.yourdomain.com with your actual domain. Enable + reload:

5. Get SSL certificate

Certbot auto-edits your nginx config to add HTTPS and HTTP to HTTPS redirect. Renewal runs automatically (test with certbot renew --dry-run).

6. Create systemd service

Create /etc/systemd/system/nexora-dashboard.service:
Enable + start:
Follow logs:

7. Verify

Open https://dash.yourdomain.com in your browser. You should see the onboarding screen. Continue at First login.

Common gotchas

  • Port 3000 already in use: change PORT in .env and update proxy_pass in nginx.
  • 502 Bad Gateway: the Node service is not running. Run systemctl status nexora-dashboard and read the log.
  • SSL fails: your domain DNS is not pointing at this server yet. Wait and retry.
  • WebSocket disconnects: make sure the /nui-ws block above is present in your nginx config.