Démarrer

Choisir le stockage

Volume nommé, bind mount et permissions UID/GID 1001:1001.

NasDash doit pouvoir écrire dans l'intégralité de /app/data. L'exemple Compose par défaut utilise un dossier hôte. Un volume nommé reste optionnel.

Bind mount (défaut)

Avantages : fichiers visibles pour les snapshots de l'hôte et les outils de sauvegarde de dossiers. Les installations existantes utilisent déjà ./data.

volumes:
  - ./data:/app/data

Préparez le dossier avant le premier lancement :

# Fresh empty directory; default container UID:GID
mkdir -p data
sudo chown 1001:1001 data
sudo chmod 700 data

L’image utilise par défaut l’UID:GID 1001:1001 ; un utilisateur Compose explicite le remplace. Pour les fichiers existants ou ACL Synology, arrêtez NasDash, sauvegardez puis donnez à l’identité réelle accès aux données et logos. N’appliquez pas aveuglément des changements récursifs de propriétaire. Consultez installation et diagnostic des permissions.

Volume nommé (optionnel)

Pour une nouvelle installation, utilisez le fichier complet docker-compose.named-volume.yml du dépôt produit. Sa déclaration de premier niveau nomme explicitement le volume nasdash-data. Continuez à utiliser ce fichier pour gérer la pile. Les droits et l’identité d’exécution restent importants, surtout avec un UID:GID personnalisé.

docker compose -f docker-compose.named-volume.yml up -d
docker compose -f docker-compose.named-volume.yml ps
docker compose -f docker-compose.named-volume.yml stop nasdash

Limite : les fichiers ne sont pas directement visibles dans l'arborescence de l'hôte Docker. Utilisez une commande de sauvegarde par conteneur temporaire. Ne l'utilisez pas sur une installation ./data existante sans copier les fichiers d'abord.

Ne pas changer implicitement de modèle

Passer de ./data au volume nasdash-data sans copier les données crée une instance apparemment vierge. Les anciennes données n'ont pas disparu, mais elles ne sont plus montées.

Avant une migration :

  1. Arrêtez NasDash.
  2. Sauvegardez toute la source.
  3. Copiez tous les fichiers, clés et fichiers cachés compris.
  4. Donnez accès à l’UID:GID réel d’exécution.
  5. Démarrez avec la nouvelle cible.
  6. Vérifiez connexion, services, topologie, logos et intégrations.