Installation avec Docker

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.

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
    depends_on:
      - docker-proxy
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: unless-stopped

  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 ce contenu dans docker-compose.yml, puis lancez :

docker compose pull
docker compose up -d --force-recreate
docker compose ps
docker compose logs nasdash

Ouvrez http://<server-ip>:2504 depuis le LAN, ou http://localhost:2504 sur l'hôte Docker. Configurez la connexion Docker locale sur docker-proxy:2375.

Le proxy n'est pas publié sur l'hôte Docker. Il autorise uniquement les familles d'API listées ; DELETE=0 garde les suppressions désactivées. pid: host reste nécessaire aux métriques de l'hôte, et host.docker.internal permet de joindre ses autres services.

Au premier démarrage, NasDash génère des mots de passe robustes et des clés cryptographiques stables, les conserve avec ses données et affiche une seule fois les mots de passe initiaux dans les logs. Le .env optionnel sert uniquement aux surcharges avancées explicites ; son absence ne bloque pas le démarrage.

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.