Erste Schritte

Docker-Installation

NasDash mit persistenten Daten und optionalen Docker-Verbindungen auf Port 2504 bereitstellen.

NasDash verwendet Port 2504 auf dem Docker-Host und 2504 im Container. Die kopierfertige Compose-Datei speichert Daten in ./data. Ersetzen Sie diesen Ordner bei einer bestehenden Installation nicht durch ein benanntes Volume.

Die Docker-Verwaltung ist optional. Wählen Sie Portainer, Dockhand, eine Docker-kompatible HTTP(S)-API oder einen Unix-Socket. Der lokale Socket-Proxy ist eine Möglichkeit; Portainer und Dockhand benötigen ihn nicht. Siehe Docker-Verbindungen.

Kopierfertiges Docker Compose

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

Speichern Sie als docker-compose.yml und bereiten Sie den Datenzugriff vor. Folgende Befehle gelten nur für ein neues leeres Linux-Verzeichnis mit Standard-UID:GID. Lesen Sie bei vorhandenen Daten, eigenem Benutzer oder Synology-ACLs zuerst den Rechteabschnitt unten.

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

Öffnen Sie http://192.0.2.10:2504 im LAN (Beispieladresse ersetzen) oder http://localhost:2504 auf dem Host. Geben Sie den Einrichtungscode ein und folgen Sie dem Leitfaden zum ersten Start. Zum Starten von NasDash ist keine Docker-Verbindung erforderlich.

Der Standardbefehl startet nur NasDash. Führen Sie für den optionalen lokalen Proxy den folgenden Befehl aus und wählen Sie unter Einstellungen → Integrationen → Docker die Option Adresse. Tragen Sie docker-proxy als Host und 2375 als Port ein; daraus entsteht http://docker-proxy:2375. Aktivieren Sie das Profil auch beim erneuten Erstellen und behalten Sie die vorhandene Dateneinbindung bei.

docker compose --profile docker-proxy up -d

Der optionale Proxy veröffentlicht keinen Host-Port; DELETE=0 deaktiviert Löschungen. pid: host teilt die Sicht auf Host-Prozesse und kann entfallen, wenn unnötig; entfernte Monitoring-Quellen benötigen es nicht. host.docker.internal erreicht Host-Dienste. Veröffentlichen Sie niemals eine unauthentifizierte Docker-API.

Bei einer Neuinstallation startet NasDash privat, erstellt nur admin, speichert seine kryptografischen Schlüssel und zeigt einmalig Setup code: XXXX-XXXX-XXXX im Protokoll. Dieser Code ist das erste Administratorpasswort; ein gesetztes NASDASH_ADMIN_PASSWORD ersetzt ihn. Die optionale .env dient erweiterten Einstellungen. Die Startseite beginnt mit einer Uhr und einem Wetter-Widget, auch wenn der Leitfaden übersprungen wird, ohne Beispieldienste, Geräte oder Docker-Host. Bestehende Installationen behalten ihre Einstellungen und Konten.

Bestehende Installation mit benanntem Volume

Behalten Sie nasdash-data:/app/data nur bei, wenn die Instanz dieses benannte Volume bereits verwendet. Ändern Sie den Speichertyp nicht während eines normalen Image-Updates.

Stoppen ohne Datenverlust

docker compose stop
docker compose down

Füge bei einem normalen Stopp kein -v hinzu. Siehe Docker und Proxy und Aktualisierungen.

Synology und Berechtigungen des Datenordners

Das Image läuft mit UID:GID 1001:1001. Erstellen Sie vor dem ersten Start den Datenordner auf dem Host und gewähren Sie dieser Identität Lese-/Schreibzugriff. Verwenden Sie auf Synology ein eigenes DSM-Konto mit passenden ACLs für diesen Ordner. Führen Sie per SSH id nasdash-user aus (Beispielnamen ersetzen) und ergänzen Sie die numerische Identität nur beim NasDash-Dienst. Dieser Ausschnitt enthält Beispielwerte, keine allgemeingültigen NAS-Werte:

services:
  nasdash:
    user: "1026:100"

Behalten Sie die vollständige Compose-Datei und den bestehenden Daten-Mount bei. Erstellen Sie den Ordner vor dem Start; prüfen Sie auch geerbte ACLs, den Zugriff auf übergeordnete Verzeichnisse, bestehende Dateien und logos. PUID/PGID werden nicht unterstützt. Eine Änderung von user überträgt kein Eigentum. Verwenden Sie weder root noch chmod 777 und löschen Sie keine Daten zur Zugriffsreparatur. Ein Image-Neubau behebt keine Host-Berechtigungen. Lehnt eine ältere Compose-Version env_file.required ab, entfernen Sie ohne .env den gesamten optionalen Block oder verwenden Sie env_file: .env mit der vorhandenen Datei.

Bereiten Sie unter Linux einen neuen leeren Ordner ./data mit mkdir -p ./data, sudo chown 1001:1001 ./data und sudo chmod 700 ./data vor. Sichern und stoppen Sie bestehende Installationen vor Zugriffsänderungen; behalten Sie deren Daten-Mount bei.

Images ab Version 0.2.2 prüfen den Zugriff vor dem Start und melden die tatsächliche UID:GID bei unzugänglichen Daten, Logos oder bestehenden Dateien. Korrigieren Sie die Berechtigungen und erstellen Sie den Container neu. UID/GID-Tests unter Docker Linux ersetzen keine Prüfung auf einem echten DSM.

Synology · Compose user