Erste Schritte
Voraussetzungen
Hardware, Software, Netzwerk und Entscheidungen, die vor der Installation vorbereitet werden müssen.
Empfohlene Docker-Installation
- Ein Linux-Host mit Docker Engine und Docker Compose
2.24.0oder neuer; - Zugriff auf die Befehlszeile mit den erforderlichen Berechtigungen zum Ausführen von Containern;
- Der TCP-Port
2504ist verfügbar, oder ein anderer gewählter Host-Port; - Persistenter Speicher für die gesamte
/app/data; - Netzwerkzugriff vom NasDash-Container zu den Ziel-Integrationen;
- Eine Backup-Strategie, die unabhängig von der primären Festplatte oder dem Volume ist.
Die mitgelieferte Compose-Datei mountet /var/run/docker.sock, eine Linux-Konvention. Docker Desktop kann NasDash ausführen, aber der lokale Docker-Zugriff muss angepasst werden, und dies ist nicht der mit der mitgelieferten Datei validierte Pfad.
Entwicklung aus dem Quellcode
- Node.js
20.9.0oder neuer; - Node.js 22 LTS empfohlen, identisch mit dem aktuellen Produktions-Image;
- npm mit der Lockfile des Repositories;
- Playwright Chromium nur, wenn Sie Browser-Tests ausführen;
- Docker, wenn Sie das Image und die Persistenz validieren.
Entscheidungen vor dem ersten Start
| Frage | Empfohlene Wahl |
|---|---|
| Wo sollen die Daten gespeichert werden? | Standardmäßig ./data; benanntes Volume nur als optionale Alternative für eine Neuinstallation |
| Wer kann das Dashboard sehen? | Privater Modus für eine Instanz, die sensible Informationen enthält |
| Fernzugriff? | Tailscale oder HTTPS-Reverse-Proxy; Port 2504 nicht direkt ins Internet veröffentlichen |
| Docker-Aktionen? | POST=1 nur bei Bedarf beibehalten und DELETE=0 standardmäßig verwenden |
| Initiales Geheimnis? | Von NasDash erzeugen und speichern lassen oder für eine erweiterte Bereitstellung ausdrücklich vorgeben |
Docker Compose überprüfen
docker version
docker compose versionDer zweite Befehl muss Compose 2.24.0 oder neuer melden. Diese Version unterstützt die optionale .env der kopierfertigen Konfiguration. Die historische Syntax docker-compose wird in den Anleitungen nicht verwendet.