Démarrer
Prérequis
Matériel, logiciel, réseau et décisions à préparer avant l'installation.
Installation Docker recommandée
- un hôte Linux avec Docker Engine et Docker Compose v2 ;
- accès en ligne de commande avec le droit de lancer des conteneurs ;
- port TCP
2504libre, ou un autre port hôte choisi ; - stockage persistant pour la totalité de
/app/data; - accès réseau depuis le conteneur NasDash vers les intégrations visées ;
- une stratégie de sauvegarde distincte du disque ou volume principal.
Le Compose fourni monte /var/run/docker.sock, une convention Linux. Docker Desktop peut exécuter NasDash, mais l'accès Docker local doit être adapté et n'est pas le chemin validé par le fichier fourni.
Développement depuis les sources
- Node.js
20.9.0ou plus récent ; - Node.js 22 LTS recommandé, identique à l'image de production actuelle ;
- npm avec le lockfile du dépôt ;
- Chromium Playwright uniquement si vous lancez les tests navigateur ;
- Docker si vous validez l'image et la persistance.
Décisions à prendre avant le premier démarrage
| Question | Choix recommandé |
|---|---|
| Où stocker les données ? | volume nommé pour démarrer simplement ; bind mount si votre NAS sauvegarde un dossier visible |
| Qui peut voir le dashboard ? | mode privé pour une instance contenant des informations sensibles |
| Accès distant ? | Tailscale ou reverse proxy HTTPS ; ne publiez pas directement le port 2504 sur Internet |
| Actions Docker ? | gardez POST=1 seulement si nécessaire et DELETE=0 par défaut |
| Secret initial ? | générez et conservez NASDASH_JWT_SECRET avant le premier démarrage |
Vérifier Docker Compose
docker version
docker compose versionLa deuxième commande doit répondre avec une version Compose v2. La syntaxe historique docker-compose n'est pas celle utilisée par les guides.