Dawarich Atlas

A local-first, self-hostable maps stack. Built on OpenStreetMap data and FOSS components, able to use locally installed search, routing and map datasets. Online basemaps, optional live transport feeds and data updates need network access.

Atlas is the maps engine that powers Dawarich, packaged so it stands on its own — install it on hardware you control, plug your own clients into the API.

What's in the box

Dawarich Atlas is a single docker compose stack with map services wired together behind one HTTP API:

Capability	Engine	Endpoint
Base map tiles	Protomaps PMTiles + MapLibre GL	/tiles/* (Caddy static)
Forward search & autocomplete	Photon	GET /api/v1/search
Reverse geocoding	Photon + Placeholder admin chain	GET /api/v1/reverse
Batch reverse geocoding	Cached + grid-snapped	POST /api/v1/reverse/batch
Routing (drive / cycle / walk)	Valhalla	GET /api/v1/route
GPS map matching	Valhalla	POST /api/v1/map-match
POI lookup	Overpass	GET /api/v1/whats-here, GET /api/v1/pois
Transit	MOTIS 2.11.2 by default; OpenTripPlanner 2 is selectable	GET /api/v1/transit
Combined geocode	Forward or reverse, one URL	GET /api/v1/geocode
Installed regional coverage	Atlas control plane	GET /api/v1/coverage

All responses share one envelope:

{ "data": "…", "meta": { "timestamp": "…", "upstream": "ok|unavailable|error" } }

Errors are uniform:

{ "error": { "code": "VALIDATION_ERROR | UPSTREAM_UNAVAILABLE | UPSTREAM_ERROR", "message": "…" } }

What's new in 0.6.1

Atlas 0.6.1 adds a live processing log to region installation and a public coverage endpoint. Clients can use GET /api/v1/coverage to discover the readiness and verified installed regions for each capability without relying on the last selection saved in Settings.

See the 0.6.1 release notes, regions and coverage, and the upgrade guide.

License

Dawarich Atlas is licensed under the GNU Affero General Public License v3.0 — the same license as Dawarich. See LICENSE for the full text.

Where to next

• Quickstart — three commands, a working map.
• Architecture — the diagram and what each layer does.
• Regions — pick city, country, continent, or planet.
• Compose profiles — turn data layers on and off without restarting the world.
• Transit engines — MOTIS by default, with OTP as an alternative.
• Map matching — snap recorded GPS tracks to the road network.
• Public API reference — Redoc-rendered OpenAPI for /api/v1/*.
• Admin API reference — Redoc-rendered OpenAPI for the /admin/* control plane.