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.0 ou plus récent ;
  • accès en ligne de commande avec le droit de lancer des conteneurs ;
  • port TCP 2504 libre, 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

QuestionChoix 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 version

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