Démarrer

Variables d'environnement

Toutes les variables déclarées dans le fichier d'exemple actuel.

Variables NasDash

VariableEnvironnementRequiseEffet
NEXT_PUBLIC_DASHBOARD_TITLEdéveloppement / buildnonvaleur de repli à la compilation si aucun titre n’est enregistré ; utilisez normalement Paramètres → En-tête ; exemple NASDASH
NASDASH_ADMIN_PASSWORDproductionnon ; nouveaux comptes uniquementpremier mot de passe de admin, à la place du code généré
NASDASH_VIEWER_PASSWORDinitialisation héritéenoninitialise 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_SECRETproductionnon ; remplacement avancésecret stable des sessions et des identifiants chiffrés
NASDASH_DATA_DIRavancé / testsnonremplace le dossier de données, normalement <project>/data
NASDASH_ALLOWED_DEV_ORIGINSdéveloppement uniquementnonliste d'hôtes/IP autorisés pour ouvrir npm run dev:lan depuis un autre appareil privé
NASDASH_DEMO_MODEdémo seulementnonactive 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.0

Générer le secret

openssl rand -hex 32

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

Dé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-secret

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