Démarrer

Installation avec Docker

Installer NasDash sur le port 2504 avec données persistantes et connexions Docker optionnelles.

NasDash utilise le port 2504 sur l'hôte Docker et 2504 dans le conteneur. Le Compose prêt à copier conserve les données dans ./data. Ne remplacez pas ce dossier par un volume nommé sur une installation existante.

La gestion Docker est optionnelle. Choisissez Portainer, Dockhand, une API compatible Docker HTTP(S) ou un socket Unix. Le proxy local est une possibilité ; Portainer et Dockhand ne le nécessitent pas. Voir les connexions Docker.

Docker Compose prêt à copier

services:
  nasdash:
    image: ghcr.io/lucas-lepajollec/nasdash:latest
    ports:
      - "2504:2504"
    env_file:
      - path: .env
        required: false
    volumes:
      - ./data:/app/data
    pid: host
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: unless-stopped

  # Optional local engine connection: docker compose --profile docker-proxy up -d
  docker-proxy:
    profiles: ["docker-proxy"]
    image: tecnativa/docker-socket-proxy:v0.5.0
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      CONTAINERS: 1
      IMAGES: 1
      VOLUMES: 1
      NETWORKS: 1
      INFO: 1
      POST: 1
      DELETE: 0
    restart: unless-stopped

Enregistrez dans docker-compose.yml. Préparez l’accès au dossier de données avant de démarrer. Les commandes ci-dessous concernent seulement un nouveau dossier Linux vide avec l’UID:GID par défaut. Pour des données existantes, un utilisateur personnalisé ou les ACL Synology, suivez d’abord la section permissions ci-dessous.

mkdir -p ./data
sudo chown 1001:1001 ./data
sudo chmod 700 ./data
docker compose pull
docker compose up -d --force-recreate
docker compose ps
docker compose logs nasdash

Ouvrez http://192.0.2.10:2504 depuis le réseau local (remplacez l’adresse d’exemple) ou http://localhost:2504 sur l’hôte. Saisissez le code de configuration et suivez le guide de premier démarrage. Aucune connexion Docker n’est nécessaire pour démarrer NasDash.

La commande par défaut démarre uniquement NasDash. Pour le proxy local facultatif, exécutez la commande ci-dessous, puis choisissez Adresse dans Paramètres → Intégrations → Docker. Saisissez docker-proxy dans le champ hôte et 2375 dans le champ port ; l’adresse obtenue est http://docker-proxy:2375. Gardez le profil activé lors des recréations et conservez le montage de données existant.

docker compose --profile docker-proxy up -d

Le proxy optionnel ne publie aucun port hôte ; DELETE=0 désactive les suppressions. pid: host partage la visibilité des processus hôte et peut être retiré si inutile ; les sources de monitoring distantes n’en dépendent pas. host.docker.internal permet de joindre les services hôte. Ne publiez jamais une API Docker sans authentification.

Sur une installation neuve, NasDash démarre en mode privé, crée uniquement admin, conserve ses clés cryptographiques et affiche une seule fois Setup code: XXXX-XXXX-XXXX dans les journaux. Ce code est le premier mot de passe administrateur ; NASDASH_ADMIN_PASSWORD le remplace si défini. Le fichier .env facultatif sert aux réglages avancés. L’Accueil commence avec une horloge et un widget météo même si le guide est passé, sans services, appareils ni hôte Docker d’exemple. Les installations existantes conservent leurs réglages et comptes.

Installation existante avec volume nommé

Gardez nasdash-data:/app/data seulement si l'instance utilise déjà ce volume nommé. Ne changez pas de type de stockage pendant une simple mise à jour d'image.

Arrêter sans supprimer les données

docker compose stop
docker compose down

N'ajoutez pas -v lors d'un arrêt normal. Voir Docker et proxy et Mises à jour.

Synology et permissions du dossier de données

L’image fonctionne avec l’UID:GID 1001:1001. Avant le premier démarrage, créez le dossier de données sur l’hôte et donnez à cette identité l’accès en lecture/écriture. Sur Synology, utilisez un compte DSM dédié avec les ACL de lecture/écriture sur ce dossier. Exécutez id nasdash-user par SSH (remplacez ce nom d’exemple), puis ajoutez son identité numérique au seul service NasDash. Cet extrait utilise des valeurs d’exemple, pas des valeurs universelles pour les NAS :

services:
  nasdash:
    user: "1026:100"

Conservez le fichier Compose complet et le montage de données existant. Créez le dossier avant de démarrer ; vérifiez aussi les ACL héritées, la traversée des dossiers parents, les fichiers existants et logos. Les variables PUID/PGID ne sont pas prises en charge. Modifier user ne transfère pas la propriété. N’utilisez pas root, chmod 777 ou la suppression des données pour corriger l’accès. Reconstruire l’image ne répare pas les permissions de l’hôte. Si un ancien Compose refuse env_file.required, supprimez tout ce bloc facultatif sans .env, ou utilisez env_file: .env avec votre fichier existant.

Sous Linux, préparez un nouveau dossier ./data vide avec mkdir -p ./data, sudo chown 1001:1001 ./data et sudo chmod 700 ./data. Sauvegardez et arrêtez une installation existante avant de modifier les accès ; conservez son montage de données.

Les images à partir de la version 0.2.2 vérifient les accès avant le démarrage et indiquent l’UID:GID réel si les données, les logos ou les fichiers existants sont inaccessibles. Corrigez les permissions du dossier, puis recréez le conteneur. Les tests UID/GID sous Docker Linux ne remplacent pas une validation sur un vrai DSM.

Synology · Compose user