Conrad Schulz a7f71ebc9b docs: agent history und project context erstmalig angelegt

- history/prompts/2026-06-03_tile-server-setup_session.md: vollständige
  Konversation dieser Session (Setup, Migration, Download)
- history/summary/PROJECT_CONTEXT.md: aktueller Projektstand

2026-06-03 10:10:42 +00:00

3.2 KiB

Raw Blame History

PROJECT_CONTEXT – rd13_tile_server

Letzte Aktualisierung: 2026-06-03 – Planet-Download läuft, Martin konfiguriert

Projektziel

Selbst gehosteter Tile Server auf Basis von Martin (Rust), der für MediaWiki, Nextcloud, Home Assistant und andere Dienste Vektorkarten bereitstellt.

Stack

Tile Server: ghcr.io/maplibre/martin:v1.10.1
Port: 9982 extern → 3000 intern
Proxy: NPM (Nginx Proxy Manager) extern – kein nginx-Sidecar
Daten: MBTiles/PMTiles in /data/
Git Remote: ssh://git@192.168.178.6:2222/cschulz/rd13_tile_server.git

Aktueller Zustand

Laufende Services

Martin-Container: noch nicht gestartet (warte auf Download)
Download data/osm.mbtiles: 🔄 ~67% (64/94 GB) – läuft in tmux-Session rd13-download

Vorhandene Daten in `/data/`

Datei/Ordner	Status
`osm.mbtiles`	🔄 Download läuft (~64 GB, fertig in ~30 Min)
`fonts/`	✅ installiert
`styles/`	✅ vorhanden
`satellite.mbtiles`	❌ noch nicht heruntergeladen

Git-Stand

Branch: main
Letzter Commit: df8518d – copilot-instructions aktualisiert
Alle Änderungen gepusht

Nächste Schritte (für nächsten Agenten)

Download prüfen:

tail -3 logs/download-osm.log
ls -lh data/osm.mbtiles  # sollte ~94 GB haben wenn fertig

Martin starten:

docker compose up -d
curl http://localhost:9982/health
curl http://localhost:9982/catalog  # sollte osm anzeigen

Satellit-Download starten (optional, ~10 GB, Zoom 0–10):

tmux new-session -d -s rd13-sat -c /mnt/services-data/rd13_tile_server \
  'python3 scripts/download-satellite.py data/satellite.mbtiles 2>&1 | tee logs/satellite.log'

NPM konfigurieren (manuell im NPM UI):
- Proxy Host: http://HOST:9982
- Advanced Config: add_header Cache-Control "public, max-age=86400, stale-while-revalidate=3600" always;

Bekannte Fallstricke

data/tmp/ und data/sources/ werden von Docker als root erstellt → sudo rm -rf nötig
Planetiler braucht sehr viel Disk (87 GB sources + 264 GB tmp + ~70 GB output = ~420 GB) → Nicht mehr nötig, wir nutzen OpenFreeMap MBTiles direkt
Fish Shell unterstützt kein heredoc << 'EOF' → Python open().write() oder tee verwenden
Download von OpenFreeMap: wget --continue für Resume-Support bei Abbruch

Erledigte Aufgaben

Git-Repo initialisiert und auf Forgejo gepusht
Migration TileServer-GL → Martin
nginx-Sidecar entfernt (NPM extern)
Port auf 9982 geändert
copilot-instructions auf aktuelles Template aktualisiert
download-data.sh + download-satellite.py erstellt
History-System (post-commit Hook + _session.md Konvention) in rd13_copilot_setup implementiert
Docs für MediaWiki, Nextcloud, Home Assistant erstellt
Planet-MBTiles Download gestartet (OpenFreeMap, 94 GB)

Offene Aufgaben

Download abwarten und Martin starten
Satellit-Download (optional)
NPM-Konfiguration (manuell)
Hook-Verteilung auf alle Repos (install-hooks.sh)
Martin mit echten Tiles testen

3.2 KiB Raw Blame History Unescape Escape