breadcrumb-the-shire/docs/howto-docker-lokal.md

Docker lokal

Letzte Aktualisierung: 2026-04-01

Ziel

Diese Anleitung bringt die Anwendung lokal schnell und stabil zum Laufen.

Voraussetzungen

• Docker Desktop (oder Docker Engine + Compose)
• Port 8080 (App) und 8081 (phpMyAdmin) sind frei
• Nginx-only Setup: .htaccess wird nicht ausgewertet

Start in 5 Schritten

1. ENV-Datei anlegen:

cp .env.example .env

2. Config-Template fuer den App-Bootstrap anlegen:

cp config/config.php.example config/config.php

3. Container bauen und starten:

docker compose up --build -d

4. Anwendung öffnen:

   • App: http://localhost:8080
   • phpMyAdmin: http://localhost:8081

5. Logs prüfen (optional):

docker compose logs -f nginx php

Security Header in Dev

Der lokale Nginx liefert bewusst dieselbe Security-Header-Baseline wie Produktion, mit einer Ausnahme:

• Kein Strict-Transport-Security (HSTS) im Dev-HTTP-Setup.

Aktive Header in Dev:

• X-Content-Type-Options: nosniff
• X-Frame-Options: SAMEORIGIN
• Referrer-Policy: strict-origin-when-cross-origin
• Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=(), usb=()
• X-Permitted-Cross-Domain-Policies: none

Nützliche Befehle

Neustart:

docker compose restart nginx php

Stoppen:

docker compose down

Scheduler-Logs:

docker compose logs -f scheduler

Häufige lokale Probleme

• Änderungen werden nicht sichtbar:
  • docker compose restart nginx php
• Datenbank startet nicht:
  • DB-Container-Logs prüfen: docker compose logs -f db
• Port-Konflikt:
  • in docker-compose.yml lokale Port-Mappings anpassen