explaingit

dawarich-app/atlas

21Ruby

TLDR

Dawarich Atlas is a self hosted mapping platform you run on your own hardware.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

In plain English

Dawarich Atlas is a self hosted mapping platform you run on your own hardware. It is built from OpenStreetMap data and a stack of free and open source components, and it is designed so that no outbound API calls happen at runtime; everything stays on the box you control. The project began as the maps engine inside Dawarich, a personal location app, and has been packaged here as a standalone product that other clients can connect to through its API. Out of the box you get a MapLibre based map page in the browser plus a side panel with four main tools: search powered by Photon, routing and directions powered by Valhalla, point of interest lookup powered by Overpass, and an admin Settings tab where you pick which services are active, which region to load, and which basemap to use. Starting it up is a docker compose flow. You clone the repo, copy a region preset such as berlin.env to .env, and run docker compose up -d. The map is reachable at localhost:8484 once the reverse proxy and the Rails app come up. From the Settings tab you pick services and the region, then click apply, and a Go sidecar takes over: it downloads the relevant OSM extracts and runs the ingest, streaming progress back to the browser over Action Cable. The README's own estimate is that a city loads in minutes, a country in hours, and the whole planet in days. The codebase is split in two: a Rails application under app/ and a Go sidecar under atlas-control/, each with its own README and test suite. GitHub Actions runs RSpec for the Rails side and go test with the race detector for the Go side, and on every push to main it publishes multi architecture Docker images (amd64 and arm64) to GHCR. The default compose file pulls those images directly with no authentication. The README is intentionally thin. Topics like architecture, region presets, scaling tables for Germany, France, USA, and the planet, compose profiles, and the full OpenAPI spec live on a separate site at atlas.dawarich.app, whose source is in a sister repository. The project is AGPL-3.0 licensed, with upstream components keeping their own licenses such as ODbL for OSM data, BSD-3 for MapLibre and Protomaps, MIT for Valhalla and Rails, and LGPL or AGPL for Photon, Overpass, and OpenTripPlanner.

Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.