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
2.24.0ou plus récent ; - 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 ? | ./data par défaut ; volume nommé seulement comme alternative optionnelle pour une install neuve |
| 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 ? | laissez NasDash le générer et le conserver, ou fournissez-le explicitement pour un déploiement avancé |
Vérifier Docker Compose
docker version
docker compose versionLa deuxième commande doit indiquer Compose 2.24.0 ou plus récent. Cette version prend en charge le .env optionnel utilisé par la configuration prête à copier. La syntaxe historique docker-compose n'est pas celle utilisée par les guides.