Self-hostable maps stack, powered by OpenStreetMap.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ellen Poe 85fbfc80f5
Merge pull request #175 from kresp0/patch-3
2 days ago
.github Fix frontend checks to use yarn 3 weeks ago
assets Use <picture> hax to work around people using Github light themes on dark theme machines. 1 month ago
contrib Merge pull request #174 from kresp0/patch-2 2 days ago
git-hooks Add pre-commit hook 5 days ago
k8s add securityContext to k8s manifests 1 week ago
services Import WOF data into elasticsearch 2 weeks ago
web Merge pull request #168 from michaelkirk/mkirk/fix-subsequent-pick-routing 5 days ago
.env.example Remove BBOX from .env-example because it's not necessary for the time being 4 months ago
.gitignore Remove bzip2 compression on artifacts 1 month ago Link to ./contrib/ 2 days ago
Earthfile Import WOF data into elasticsearch 2 weeks ago Add a full planet markdown doc 3 weeks ago
LICENSE Relicense to apache 2.0 4 months ago Typo: verion => version 1 week ago Update 2 weeks ago
docker-compose.yaml Import WOF data into elasticsearch 2 weeks ago


GitHub Actions status badge License badge GitHub last commit badge GitHub commit activity badge

World map image

Headway is a maps stack in a box that makes it easy to take your location data into your own hands. With just a few commands you can bring up your own fully functional maps server. This includes a frontend, basemap, geocoder and routing engine. Choose one of the 200+ predefined cities or provide your own OpenStreetMap extract covering any area: from a neighborhood to the whole planet.

See for more information about the build process.


Headway is currently capable of showing a map, searching for points of interest and addresses within an OpenStreetMap extract and providing directions between any two places within that extract. Supported modes include driving, cycling and walking. Transit directions are a work-in-progress.

System Requirements

Headway has been confirmed working on amd64 machines running Linux and macOS. The machine used for generation of the data files needs to have at least 8GB of memory, potentially more for larger areas. The requirements for running an instance of the stack are lower though. Expect to need around 4GB for a medium sized metro area. Additionally, you should expect to need 50GB-100GB of disk space during the build process.


Headway is available freely under the terms of the Apache License, version 2.0. Please consider opening a PR for any enhancements or bugfixes!