# XYZ tile map (OpenStreetMap / Google Maps style) - see docs/MAPS.md.
#
# Serves the tile pyramid + the viewing interface + generation (delegated to
# the processing machine via LIDAR_GENERATION_URL on a lightweight machine,
# local on the full image). Same output/ folder as the pipeline; tiles are
# rendered on demand (or ahead of time with LIDAR_TILE_BACKGROUND=1) and
# cached in output/index_xyz/.
#
#   docker compose -f docker-compose.maps.yml up -d --build
#   docker compose -f docker-compose.maps.yml logs -f maps
#   docker compose -f docker-compose.maps.yml down
services:
  maps:
    build:
      context: .
      dockerfile: Dockerfile.maps
    image: lidar-maps
    container_name: lidar-maps
    init: true
    user: "1000:1000"
    ports:
      - "8975:8975"
    volumes:
      # Reads the source tiles + writes the tile cache (output/index_xyz/)
      - ./output:/data/output
    environment:
      - TZ=Europe/Paris
      - LIDAR_OUTPUT_DIR=/data/output
      # Tile generator (worker, see docker-compose.worker.yml): generation
      # started from the map is delegated to it. Without this variable AND
      # without a local pipeline, the Generation tab is hidden (view-only
      # lightweight image).
      # - LIDAR_GENERATION_URL=http://192.168.1.50:8973
      # Token, if the worker requires LIDAR_API_TOKEN.
      # - LIDAR_REMOTE_TOKEN=shared-secret
      # Network allowed to start generations (default: localhost +
      # RFC1918 private ranges; CIDR list, empty = allow everything).
      # - LIDAR_REGEN_CIDR=192.168.1.0/24
      # Upstream SOURCE-TILE server (the worker's mapserve): without local data,
      # the inventory comes from its /api/tiles and images are fetched on
      # demand into ./output - enough to serve a whole remote catalogue.
      # - LIDAR_SOURCE_URL=http://192.168.1.50:8973
      # Upstream XYZ TILE server (the worker or another lidar-maps instance)
      # for a remote map (Raspberry Pi): a tile missing locally is fetched from it.
      # - LIDAR_MAPS_URL=http://192.168.1.50:8975
      # Attribution text served in TileJSON, WMTS, JOSM and the map.
      # - LIDAR_ATTRIBUTION=LiDAR HD © IGN - Licence Ouverte 2.0
      # Maximum load: concurrent renders and downloads, memory of the source
      # image cache. Defaults (shown) sized for a small machine; raise them
      # on a comfortable server.
      # - LIDAR_TILE_WORKERS=2
      # - LIDAR_TILE_FETCH_WORKERS=2
      # - LIDAR_TILE_SOURCE_CACHE_MB=192
      # Full pyramid (default): every level up to native (z19, 0.2 m/px) is
      # stored on disk (and generated ahead of time with LIDAR_TILE_BACKGROUND=1).
      # Reduced storage: even levels only and/or a lower cap, the rest rendered
      # on the fly with an in-memory cache.
      # - LIDAR_TILE_CACHE_MAX_Z=16
      # - LIDAR_TILE_EVEN_LEVELS=1
      # - LIDAR_TILE_MEMORY_CACHE_MB=64
    restart: unless-stopped