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.0 oder neuer;
  • Zugriff auf die Befehlszeile mit den erforderlichen Berechtigungen zum Ausführen von Containern;
  • Der TCP-Port 2504 ist 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.

Der Standardstart benötigt keinen Docker-Socket. Nur das optionale lokale Proxy-Profil mountet /var/run/docker.sock, eine Linux-Konvention. Portainer oder Dockhand benötigen diesen Mount nicht; Docker Desktop kann Netzwerkanpassungen benötigen. Siehe Docker-Verbindungen.

Entwicklung aus dem Quellcode

  • Node.js 22.x, passend zur Engine und zum Produktionsimage;
  • npm mit Repository-Lockfile;
  • Playwright Chromium für Browserprüfungen;
  • Docker für Image- und Speicherprüfungen.

Entscheidungen vor dem ersten Start

FrageEmpfohlene 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 version

Der 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.