Variables de entorno
Todas las variables declaradas en el archivo de ejemplo actual.
Variables de NasDash
| Variable | Entorno | Obligatorio | Efecto |
|---|---|---|---|
NEXT_PUBLIC_DASHBOARD_TITLE | desarrollo / compilación | no | valor de respaldo al compilar si no hay un título guardado; normalmente use Ajustes → Cabecera; ejemplo NASDASH |
NASDASH_ADMIN_PASSWORD | producción | no; solo cuentas nuevas | primera contraseña de admin, en lugar del código generado |
NASDASH_VIEWER_PASSWORD | inicialización heredada | no | solo inicializa una cuenta viewer antigua con hash provisional; no crea un lector en una instalación nueva ni define la contraseña del creado por el modo público |
NASDASH_JWT_SECRET | producción | no; opción avanzada | secreto estable para sesiones y credenciales cifradas |
NASDASH_DATA_DIR | avanzado / pruebas | no | reemplaza el directorio de datos, normalmente <project>/data |
NASDASH_ALLOWED_DEV_ORIGINS | solo desarrollo | no | lista de hosts/IPs autorizados para abrir npm run dev:lan desde otro dispositivo privado |
NASDASH_DEMO_MODE | solo demostración | no | habilita datos ficticios y deshabilita las conexiones reales |
Variables de la imagen
La imagen define estos valores predeterminados; Compose carga un archivo de entorno opcional:
NODE_ENV=production
PORT=2504
HOSTNAME=0.0.0.0Generación del secreto
openssl rand -hex 32No se necesita secreto de entorno: NasDash guarda jwt.secret y encryption.key en los datos. Defina NASDASH_JWT_SECRET solo como opción avanzada en la primera instalación. Tras cifrar credenciales, mantenga la misma configuración al reiniciar, guardar y actualizar: añadir o cambiar la opción puede impedir leerlas e invalidar sesiones.
Sin una contraseña predefinida
En una instalación nueva, NasDash muestra un solo Setup code: XXXX-XXXX-XXXX en los registros. Es la primera contraseña del administrador. Introdúzcalo en la pantalla de primer inicio y elija después una nueva contraseña de al menos 12 caracteres en la guía. No se crea ningún lector por defecto.
docker compose logs nasdashDefina las contraseñas de las cuentas existentes en Ajustes → Usuarios y acceso. Cambiar las variables de entorno nunca restablece una contraseña existente. Si pierde el acceso, use la recuperación sin conexión.
Archivo .env
NASDASH_ADMIN_PASSWORD=replace-with-a-unique-password
NASDASH_JWT_SECRET=replace-with-a-stable-random-secretNunca commitee .env. No copie un secreto de producción en la demostración pública ni en un informe de error.
Para limitar peticiones, las direcciones de cliente transmitidas por cabeceras de proxy se ignoran por defecto. Active NASDASH_TRUST_PROXY=true solo detrás de un proxy fiable que sustituya las cabeceras del cliente e impida el acceso directo a NasDash. En otro caso conserve NASDASH_TRUST_PROXY=false. Solo cambia la identidad de los límites; no modifica detección HTTPS ni cookies de autenticación. Los intentos fallidos también se limitan por cuenta, independientemente de las cabeceras.