Get started

Environment Variables

All variables declared in the current sample file.

NasDash Variables

VariableEnvironmentRequiredEffect
NEXT_PUBLIC_DASHBOARD_TITLEdevelopment / buildnopublic title of the interface; sample value NASDASH
NASDASH_ADMIN_PASSWORDproductionrecommended on first startupinitial password for the admin account
NASDASH_VIEWER_PASSWORDproductionrecommended on first startupinitial password for the viewer account
NASDASH_JWT_SECRETproductionstrongly recommendedstable secret for sessions and encrypted credentials
NASDASH_DATA_DIRadvanced / testingnoreplaces the data directory, normally <projet>/data
NASDASH_ALLOWED_DEV_ORIGINSdevelopment onlynolist of hosts/IPs authorized to open npm run dev:lan from another private device
NASDASH_DEMO_MODEdemo onlynoenables fictitious fixtures and disables real connections

Image Variables

The Compose files also define:

NODE_ENV=production
PORT=2504
HOSTNAME=0.0.0.0

Generating the Secret

openssl rand -hex 32

The value must remain identical across restarts and updates. If you change it after saving integration credentials, they may become undecryptable and all sessions will be invalidated.

If Passwords Remain Empty

NasDash generates robust passwords on first startup and displays them once in the logs:

docker compose logs nasdash

Change them subsequently from the security settings.

.env File

NASDASH_ADMIN_PASSWORD=exemple-a-remplacer
NASDASH_VIEWER_PASSWORD=exemple-a-remplacer
NASDASH_JWT_SECRET=exemple-hexadecimal-a-remplacer

Never commit .env. Do not copy a production secret into the public demo or a bug report.