DDART installieren (Windows) – Installationsanleitung

Was Sie brauchen

Betriebssystem	Windows 10 oder Windows 11 (64-Bit)
Arbeitsspeicher	mindestens 8 GB (16 GB empfohlen, wenn Sie LiDAR-Daten auswerten)
Festplatte	mindestens 10 GB frei (plus Platz für Ihre Drohnendaten)
Internet	für die Installation (danach läuft DDART auch offline)

1Docker Desktop installieren

DDART läuft in sogenannten Containern. Das heißt: Alles, was DDART braucht, ist bereits mitverpackt – Sie müssen nichts einzeln installieren. Dafür benötigen Sie Docker Desktop.

Öffnen Sie https://www.docker.com/products/docker-desktop/
Klicken Sie auf Download for Windows und starten Sie die heruntergeladene Datei.
Klicken Sie sich durch die Installation (Standardeinstellungen übernehmen). Falls gefragt wird, ob WSL 2 verwendet werden soll: Ja.
Starten Sie den Computer neu, wenn Sie dazu aufgefordert werden.
Starten Sie Docker Desktop über das Startmenü. Warten Sie, bis unten links der Status grün ist („Engine running").

Wichtig – Arbeitsspeicher einstellen: Klicken Sie in Docker Desktop oben rechts auf das Zahnrad → Resources → stellen Sie Memory auf mindestens 6 GB. Ohne diese Einstellung kann die LiDAR-Auswertung mit einer Fehlermeldung abbrechen. Anschließend auf Apply & restart klicken.

2DDART entpacken

Legen Sie einen Ordner an, z. B. C:\DDART
Entpacken Sie die Datei ddart-x.y.z.tar.gz (bzw. das ZIP-Archiv) in diesen Ordner.
Danach liegt in C:\DDART unter anderem die Datei docker-compose.yml und der Ordner daten. Wenn ja, ist alles richtig.

3DDART starten

Öffnen Sie den Ordner C:\DDART im Windows-Explorer.
Klicken Sie oben in die Adressleiste, tippen Sie cmd und drücken Sie Enter. (Es öffnet sich ein schwarzes Fenster – die Eingabeaufforderung – bereits im richtigen Ordner.)
Alternativ gehen Sie im Windows-Explorer in den Ordner C:\DDART, halten Umschalt (Shift) gedrückt und machen gleichzeitig einen Rechtsklick in einen freien Bereich. Im Auswahlmenü wählen Sie „PowerShell-Fenster hier öffnen".
Tippen Sie folgenden Befehl und drücken Sie Enter:
```
docker compose up -d --build
```
Beim ersten Mal dauert das 5–15 Minuten – DDART lädt alle benötigten Komponenten herunter. Sie sehen viele Textzeilen; das ist normal. Warten Sie, bis wieder eine Eingabezeile erscheint.
Öffnen Sie Ihren Browser und rufen Sie diese Adresse auf:
http://localhost:5173

✓ Fertig – DDART läuft.

Tägliche Nutzung

Was Sie tun möchten	So geht's
DDART öffnen	Docker Desktop starten, dann im Browser http://localhost:5173 aufrufen
DDART stoppen	Im Ordner `C:\DDART` in der Eingabeaufforderung: `docker compose down`
DDART wieder starten	`docker compose up -d` (ohne `--build`, geht in Sekunden)

DDART startet automatisch mit, sobald Docker Desktop läuft. Sie müssen die Befehle also in der Regel nur einmal eingeben.

Ihre Daten

Alle Ihre Daten liegen im Ordner C:\DDART\daten – ein Unterordner pro Bestand:

daten\
  012-musterfeld\
    bestand.md          ← Stammdaten des Bestands
    tiff\               ← Ihre Orthofotos, DGM/DOM, Indexkarten (GeoTIFF)
    fotos\              ← Fotos vom Feld
    lidar\              ← Punktwolken (LAS/LAZ)

Sichern Sie regelmäßig den Ordner daten – er enthält Ihre gesamte Arbeit. Für ein Update von DDART tauschen Sie nur die Programmdateien aus; der Ordner daten bleibt unverändert bestehen.

Ihr Logo und Ihre Fußzeile im PDF-Bericht

DDART erstellt PDF-Berichte mit Ihrem eigenen Branding:

Öffnen Sie einen beliebigen Bestand.
Wechseln Sie auf den Reiter Bericht.
Laden Sie Ihr Logo hoch (PNG oder JPG) und tragen Sie Ihren Fußzeilentext ein (z. B. Firma, Website, E-Mail).
Auf Einstellungen speichern klicken.

Die Einstellungen gelten für alle Bestände und alle künftigen PDF-Berichte.

Wenn etwas nicht funktioniert

Der Browser zeigt „Diese Seite kann nicht erreicht werden"

→ Läuft Docker Desktop (Status grün)? Warten Sie nach dem Start ca. 30 Sekunden und laden Sie die Seite neu.

Fehlermeldung „Bad Gateway" oder die Auswertung bricht ab

→ Meist zu wenig Arbeitsspeicher. Docker Desktop → Zahnrad → Resources → Memory auf 6 GB oder mehr stellen → Apply & restart.

„docker" wird nicht als Befehl erkannt

→ Docker Desktop ist nicht installiert oder nicht gestartet. Siehe Schritt 1.

Ich möchte sehen, was im Hintergrund passiert

→ In der Eingabeaufforderung im Ordner C:\DDART:

docker compose logs -f backend

(Beenden mit Strg + C.)

Der Port 5173 ist bereits belegt

→ Öffnen Sie docker-compose.yml in einem Texteditor und ändern Sie unter frontend die Zeile - "5173:80" z. B. in - "8080:80". Danach docker compose up -d und die Adresse http://localhost:8080 verwenden.