Variables d'environnement
Toutes les variables déclarées dans le fichier d'exemple actuel.
Variables NasDash
| Variable | Environnement | Requise | Effet |
|---|---|---|---|
NEXT_PUBLIC_DASHBOARD_TITLE | développement / build | non | valeur de repli à la compilation si aucun titre n’est enregistré ; utilisez normalement Paramètres → En-tête ; exemple NASDASH |
NASDASH_ADMIN_PASSWORD | production | non ; nouveaux comptes uniquement | premier mot de passe de admin, à la place du code généré |
NASDASH_VIEWER_PASSWORD | initialisation héritée | non | initialise seulement un ancien compte viewer avec empreinte provisoire ; ne crée pas de lecteur sur une installation neuve et ne définit pas le mot de passe du compte créé par le mode public |
NASDASH_JWT_SECRET | production | non ; remplacement avancé | secret stable des sessions et des identifiants chiffrés |
NASDASH_DATA_DIR | avancé / tests | non | remplace le dossier de données, normalement <project>/data |
NASDASH_ALLOWED_DEV_ORIGINS | développement uniquement | non | liste d'hôtes/IP autorisés pour ouvrir npm run dev:lan depuis un autre appareil privé |
NASDASH_DEMO_MODE | démo seulement | non | active les fixtures fictives et neutralise les connexions réelles |
Variables de l'image
L’image définit ces valeurs par défaut ; Compose charge un fichier d’environnement facultatif :
NODE_ENV=production
PORT=2504
HOSTNAME=0.0.0.0Générer le secret
openssl rand -hex 32Aucun secret d’environnement n’est requis : NasDash conserve jwt.secret et encryption.key dans ses données. Définissez NASDASH_JWT_SECRET uniquement comme option avancée à la première installation. Une fois les identifiants chiffrés, gardez la même configuration de clés lors des redémarrages, sauvegardes et mises à jour : ajouter ou changer cette option peut rendre les identifiants illisibles et invalider les sessions.
Sans mot de passe prédéfini
Sur une installation neuve, NasDash affiche un seul Setup code: XXXX-XXXX-XXXX dans les journaux. C’est le premier mot de passe administrateur. Saisissez-le sur l’écran de premier démarrage, puis choisissez un nouveau mot de passe d’au moins 12 caractères dans le guide. Aucun lecteur n’est créé par défaut.
docker compose logs nasdashDéfinissez les mots de passe des comptes existants dans Paramètres → Utilisateurs et accès. Modifier les variables d’environnement ne réinitialise jamais un mot de passe existant. En cas d’accès perdu, utilisez la récupération hors ligne.
Fichier .env
NASDASH_ADMIN_PASSWORD=replace-with-a-unique-password
NASDASH_JWT_SECRET=replace-with-a-stable-random-secretNe commitez jamais .env. Ne copiez pas un secret de production dans la démo publique ou dans un rapport de bug.
Pour les limites de requêtes, les adresses transmises par les en-têtes de proxy sont ignorées par défaut. Activez NASDASH_TRUST_PROXY=true seulement derrière un proxy de confiance qui remplace les en-têtes fournis par le client et interdit l’accès direct à NasDash. Sinon gardez NASDASH_TRUST_PROXY=false. Ce réglage change uniquement l’identité des quotas ; il ne modifie ni la détection HTTPS ni les cookies d’authentification. Les échecs de connexion sont aussi limités par compte, indépendamment des en-têtes.