randy
c66ae8d2d0
Bind-mounting data/kiwix/ (the directory) meant a symlink placed inside it broke: the container has to resolve that symlink itself, in its own filesystem, where the host path it points to doesn't exist. Binding the exact data/kiwix/wikipedia.zim file path instead resolves it on the host at mount time (plain mount(2) semantics), so the real ZIM can live anywhere on the host without duplicating a multi-GB file into this repo's data/ directory.
78 lines
4.1 KiB
YAML
78 lines
4.1 KiB
YAML
services:
|
|
maptool:
|
|
build: .
|
|
image: maptool:latest
|
|
restart: unless-stopped
|
|
ports:
|
|
- "4567:4567"
|
|
environment:
|
|
# "[::]", not "0.0.0.0": binding the IPv6 wildcard also accepts IPv4
|
|
# connections (dual-stack is the Linux default), so this covers both
|
|
# without a second listener. Puma's bind URL needs the brackets around
|
|
# a literal IPv6 address (config/puma.rb interpolates this as-is).
|
|
BIND_HOST: "[::]"
|
|
RACK_ENV: production
|
|
# Read from .env (docker compose loads it automatically) — not
|
|
# committed, see docs/deployment.adoc.
|
|
SESSION_SECRET: ${SESSION_SECRET:?SESSION_SECRET is required, see docs/deployment.adoc}
|
|
GITEA_OAUTH_CLIENT_ID: ${GITEA_OAUTH_CLIENT_ID:?GITEA_OAUTH_CLIENT_ID is required, see docs/deployment.adoc}
|
|
GITEA_OAUTH_CLIENT_SECRET: ${GITEA_OAUTH_CLIENT_SECRET:?GITEA_OAUTH_CLIENT_SECRET is required, see docs/deployment.adoc}
|
|
MAPTOOL_ALLOWED_GITEA_USER: ${MAPTOOL_ALLOWED_GITEA_USER:?MAPTOOL_ALLOWED_GITEA_USER is required, see docs/deployment.adoc}
|
|
# Optional: blank disables the LiveTrack webhook endpoint rather than
|
|
# failing to start, since it's not needed for the app's core function.
|
|
LIVETRACK_WEBHOOK_SECRET: ${LIVETRACK_WEBHOOK_SECRET:-}
|
|
# The kiwix service below, reached by its compose service name (both
|
|
# are on the same default compose network) — port matches its own
|
|
# --port=8080 in the command below. Not made conditional on the ZIM
|
|
# actually being present: GET /api/kiwix pings it and just reports
|
|
# unavailable if the container isn't up/reachable, same story as
|
|
# every other optional-local-file feature (offline.pmtiles, etc).
|
|
KIWIX_URL: "http://kiwix:8080"
|
|
volumes:
|
|
# Uploaded GPX files and the offline PMTiles extract — kept outside
|
|
# the image so a rebuild/redeploy doesn't wipe them (see
|
|
# docs/development.adoc for how the deploy job treats this
|
|
# directory).
|
|
- ./data:/app/data
|
|
|
|
# Fakes a GNSS fix (a loop around Bratislava, see
|
|
# bin/gnss_simulator.rb/docs/development.adoc) since there's no real
|
|
# receiver attached here — the "GNSS" control would otherwise just show
|
|
# "no fix" always. Remove this service (and nothing else) whenever a real
|
|
# receiver/gpsd setup replaces it. network_mode ties it to maptool's own
|
|
# network namespace rather than a bridge network, since GpsdClient
|
|
# connects to a hardcoded 127.0.0.1:2947 — same as gpsd itself normally
|
|
# being local to the machine it serves.
|
|
gnss-simulator:
|
|
image: maptool:latest
|
|
depends_on:
|
|
- maptool
|
|
restart: unless-stopped
|
|
network_mode: "service:maptool"
|
|
command: ["ruby", "bin/gnss_simulator.rb"]
|
|
|
|
# Serves an offline Wikipedia ZIM for the popup's "Nearby on Wikipedia"
|
|
# link (see docs/development.adoc for where to get one and drop it in —
|
|
# same "not part of the repo, place it under ./data locally" story as
|
|
# offline.pmtiles/terrain.pmtiles). On the default compose network (not
|
|
# network_mode: "service:maptool" — unlike gnss-simulator this doesn't
|
|
# need a hardcoded localhost port, KIWIX_URL above reaches it by this
|
|
# service's own name), so maptool and kiwix stay independent containers.
|
|
# Keeps restarting (harmlessly) if data/kiwix/wikipedia.zim isn't there
|
|
# yet — GET /api/kiwix just reports unavailable until it comes up.
|
|
#
|
|
# The volume binds the exact *file* path, not the data/kiwix/ directory —
|
|
# deliberately, so data/kiwix/wikipedia.zim can be a symlink to wherever
|
|
# the (large) real ZIM actually lives. A bind mount resolves a symlink at
|
|
# its *source* path once, at mount time (plain mount(2) semantics, same
|
|
# as Podman); a symlink sitting inside an already-mounted directory
|
|
# doesn't get that treatment — the container would have to resolve it
|
|
# itself, inside its own filesystem, where the host path it points to
|
|
# doesn't exist.
|
|
kiwix:
|
|
image: ghcr.io/kiwix/kiwix-serve:latest
|
|
restart: unless-stopped
|
|
command: ["--port=8080", "/data/wikipedia.zim"]
|
|
volumes:
|
|
- ./data/kiwix/wikipedia.zim:/data/wikipedia.zim
|