Project OSRM: C++ backend
C++ Cucumber JavaScript CMake Lua Shell Other
Latest commit d1f555d Sep 7, 2016 @daniel-j-h daniel-j-h committed with MoKob Removes unused JSON logger.
- #2769
Failed to load latest commit information.
.github add a PR template to the repo Aug 19, 2016
cmake Fix various issues with pkg-config Jun 4, 2016
docker [skip ci] Update docker files to gcc 5 Jul 21, 2016
docs Better documents profile request parameter, resolves #2952 Sep 28, 2016
example Added 'return EXIT_SUCCESS' (#2710) Jul 27, 2016
features Added profile files per test generation Sep 28, 2016
fuzz Enable data flow guided fuzzing using traces Aug 19, 2016
include Removes unused JSON logger. Sep 28, 2016
profiles Reworks Restriction Whitelist / Blacklist, resolves #2833 Sep 28, 2016
scripts Added gdb pretty printers Aug 2, 2016
src Removes unused JSON logger. Sep 28, 2016
test Add benchmark target to Makefile and save timings Apr 5, 2016
third_party Rip out custom CSV parser code and its third_party dependency May 18, 2016
unit_tests Adds a limit for number of results returned in Nearest service, resol… Sep 12, 2016
.clang-format expose lanes as enums, adjusted for comments Jun 27, 2016
.clang-tidy Integration scripts for Clang's Modernize and Tidy tool. Sep 22, 2015 Add simple cncc file Jan 5, 2016
.eslintrc Rewrite cucumber test suite in JS Mar 24, 2016
.gitignore Implement Turn Lane Api Jun 27, 2016
.gitmodules Removing Docs submodule Dec 26, 2012
.travis.yml set cacher timeout just under 10 minutes Aug 5, 2016 make changelog readable Sep 28, 2016
CMakeLists.txt Removes unused JSON logger. Sep 28, 2016 [skip ci] Add docs for contributing Jul 19, 2016 Exclude new node_modules folder that might be around if test cases ha… Apr 5, 2016
LICENCE.TXT We are at 2016 for the license Jan 4, 2016 Talk to us! Jul 28, 2016
appveyor-build.bat [skip travis] make AppVeyor publish binaries again Apr 29, 2016
appveyor.yml Remove develop branch from appveyor Apr 23, 2016
build-local.bat make AppVeyor work again Mar 31, 2016
codecov.yml Fix codecov.yml May 12, 2016
cucumber.js Close GH-2795: Rewrite cucumber test caching (and support logic). Fixes Sep 19, 2016
package.json Close GH-2795: Rewrite cucumber test caching (and support logic). Fixes Sep 19, 2016
profile.lua readding profile.lua Jul 2, 2013
taginfo.json Handle HOV designated-only Lanes, resolves #2929 Sep 21, 2016


The Open Source Routing Machine is a high performance routing engine written in C++11 designed to run on OpenStreetMap data.

Current build status

build config status
Linux Build Status
Windows Build status
Coverage codecov


  • IRC: server, channel: #osrm (see:, and for a webchat:
  • Mailinglist:


For instructions on how to build and run OSRM, please consult the Wiki.

To quickly try OSRM use our free and daily updated online service


Full documentation

Quick start

Building OSRM assuming all dependencies are installed:

mkdir -p build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
sudo cmake --build . --target install

Loading preparing a dataset and starting the server:

osrm-extract data.osm.pbf -p profiles/car.lua
osrm-contract data.osrm
osrm-routed data.osrm

Running a query on your local server:


Running a request against the Demo Server

First read the API usage policy.

Then run simple query with instructions and alternatives on Berlin:


References in publications

When using the code in a (scientific) publication, please cite

 author = {Luxen, Dennis and Vetter, Christian},
 title = {Real-time routing with OpenStreetMap data},
 booktitle = {Proceedings of the 19th ACM SIGSPATIAL International Conference on Advances in Geographic Information Systems},
 series = {GIS '11},
 year = {2011},
 isbn = {978-1-4503-1031-4},
 location = {Chicago, Illinois},
 pages = {513--516},
 numpages = {4},
 url = {},
 doi = {10.1145/2093973.2094062},
 acmid = {2094062},
 publisher = {ACM},
 address = {New York, NY, USA},