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 démarrage standard ne nécessite aucun socket Docker. Seul le profil de proxy local optionnel monte /var/run/docker.sock, une convention Linux. Portainer et Dockhand fonctionnent sans ce montage ; Docker Desktop peut demander un réseau adapté. Voir les connexions Docker.
Développement depuis les sources
- Node.js
22.x, conforme au moteur déclaré et à l’image du produit ; - npm avec le lockfile du dépôt ;
- Playwright Chromium pour les tests navigateur ;
- Docker pour vérifier image et 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.