---
title: Lokale Umgebung
description: Dev-Stack starten, Backend und Frontend lokal entwickeln.
---

## Voraussetzungen

- Docker mit Compose
- Go (Version laut `backend/go.mod`)
- Node.js 26 wie in CI und Images (Frontend und Handbuch; `.nvmrc` im Repository)

## Kompletter Dev-Stack

```bash
docker compose -f docker-compose.dev.yml up --build
```

| Adresse | Dienst |
| --- | --- |
| https://elw.localhost | Lagewerk (Anmeldung `admin` / `admin`) |
| https://handbuch.localhost | Dieses Handbuch |
| https://rustfs.localhost | Objektspeicher-Konsole |
| https://traccar.localhost | Traccar für Tracking-Tests |
| https://webhook-sim.localhost | Tracker-Simulator |
| https://divera-sim.localhost | Divera-24/7-Simulator (Anbindung „Divera 24/7“ mit Server-Adresse `http://divera-sim:8091`) |
| `ipp://drucker-sim:631/printers/Testdrucker` | Virtueller Drucker (CUPS, nur im Compose-Netz) für das Gateway-Plugin Drucker; Druckweg CUPS mit Warteschlange `Testdrucker` über den gemeinsamen Socket |

Caddy stellt Zertifikate über eine interne CA aus; die Browserwarnung einmal bestätigen oder die
Caddy-Root-CA importieren.

Für E-Mail läuft zusätzlich der Testserver **GreenMail** (nur im Compose-Netz, SMTP 3025, IMAP
3143, ohne TLS). Jede Adresse ist ein Postfach, jedes Passwort gilt. Ein Test-Postfach in der
Verwaltung: IMAP- und SMTP-Server `greenmail`, IMAP-Benutzer die Adresse (z. B.
`ils@lagewerk.test`), Verschlüsselung „Keine (nur Testserver)“. Mails an diese Adresse holt das
Postfach dann wieder ab, etwa als Alarmeingang.

## Backend und Frontend einzeln

```bash
cd backend && go run .
cd frontend && npm run dev
```

:::warning
Ein neues Top-Level-Go-Paket braucht eine eigene `COPY`-Zeile in `backend/Dockerfile`. Der
Fehler fällt sonst erst im Image-Build auf.
:::
