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-stoppedSpeichern 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 -dDer 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 downFü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.