Primeros pasos

Variables de entorno

Todas las variables declaradas en el archivo de ejemplo actual.

Variables de NasDash

VariableEntornoObligatorioEfecto
NEXT_PUBLIC_DASHBOARD_TITLEdesarrollo / compilaciónnovalor de respaldo al compilar si no hay un título guardado; normalmente use Ajustes → Cabecera; ejemplo NASDASH
NASDASH_ADMIN_PASSWORDproducciónno; solo cuentas nuevasprimera contraseña de admin, en lugar del código generado
NASDASH_VIEWER_PASSWORDinicialización heredadanosolo 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_SECRETproducciónno; opción avanzadasecreto estable para sesiones y credenciales cifradas
NASDASH_DATA_DIRavanzado / pruebasnoreemplaza el directorio de datos, normalmente <project>/data
NASDASH_ALLOWED_DEV_ORIGINSsolo desarrollonolista de hosts/IPs autorizados para abrir npm run dev:lan desde otro dispositivo privado
NASDASH_DEMO_MODEsolo demostraciónnohabilita 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.0

Generación del secreto

openssl rand -hex 32

No 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 nasdash

Defina 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-secret

Nunca 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.