explaingit

dawarich-app/atlas

Analysis updated 2026-06-24

21RubyAudience · ops devopsComplexity · 4/5LicenseSetup · hard

TLDR

Self hosted Docker compose mapping platform built on OpenStreetMap data, MapLibre, Photon, Valhalla, and Overpass with a Rails app plus a Go sidecar that ingests region extracts on demand.

Mindmap

mindmap
  root((atlas))
    Inputs
      OSM extracts
      Region env presets
      Settings choices
    Outputs
      Browser map at 8484
      Search results
      Routes
      POI lookups
    Use Cases
      Self host maps
      Power a personal location app
      Offline directions
    Tech Stack
      Ruby on Rails
      Go
      MapLibre
      Docker
    Services
      Photon
      Valhalla
      Overpass
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Self host a private OpenStreetMap stack with search, routing, and POI in one Docker compose

USE CASE 2

Power a personal location tracking app like Dawarich without third party map APIs

USE CASE 3

Run an offline regional map server on a homelab box

USE CASE 4

Provide private routing for an internal logistics tool

What is it built with?

RubyRailsGoMapLibreDockerPostgreSQL

How does it compare?

dawarich-app/atlasjacksonpires/rails-realtime-erdcrisxuan/agent-workflow-kit
Stars212119
LanguageRubyRubyRuby
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Region ingest is heavy: a city takes minutes, a country hours, and the planet days, so disk and bandwidth need to be sized before docker compose up.

AGPL-3.0 license, free to self host, but any networked service built on top must release its source code under the same license.

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.

Copy-paste prompts

Prompt 1
Walk me through copying berlin.env to .env and bringing up dawarich-app atlas with docker compose
Prompt 2
Estimate disk and RAM needs for dawarich-app atlas when loading Germany compared to a single city
Prompt 3
Show me how to add a custom basemap to dawarich-app atlas through the Settings tab
Prompt 4
Write a reverse proxy config that exposes dawarich-app atlas on https with a Let's Encrypt cert
Prompt 5
Compare dawarich-app atlas against running Photon, Valhalla, and a tile server as separate containers

Frequently asked questions

What is atlas?

Self hosted Docker compose mapping platform built on OpenStreetMap data, MapLibre, Photon, Valhalla, and Overpass with a Rails app plus a Go sidecar that ingests region extracts on demand.

What language is atlas written in?

Mainly Ruby. The stack also includes Ruby, Rails, Go.

What license does atlas use?

AGPL-3.0 license, free to self host, but any networked service built on top must release its source code under the same license.

How hard is atlas to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is atlas for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.