Project OSRM: C++ backend
C++ Cucumber JavaScript CMake Lua Shell Other
Latest commit cb57cca Aug 25, 2016 @TheMarex TheMarex committed on GitHub Merge pull request #2805 from rkcpi/centos-build-fix
Fix build on CentOS
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 [skip ci] Iterate on the release docs Aug 5, 2016
example Added 'return EXIT_SUCCESS' (#2710) Jul 27, 2016
features improve segregated road detection Aug 24, 2016
fuzz Enable data flow guided fuzzing using traces Aug 19, 2016
include improve segregated road detection Aug 24, 2016
profiles Add local maxspeed for Netherland Aug 22, 2016
scripts Added gdb pretty printers Aug 2, 2016
src make collapse work by better detecting continue/non-continue situations Aug 24, 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 JSON instruction serialization fix. Aug 8, 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 fix segmentation fault for via-routes with invalid intermediate segments Aug 23, 2016
CMakeLists.txt Use c++1y instead of c++14 Aug 23, 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 adding tests for guidance Apr 8, 2016
package.json update cucumber to 1.2.1 and remove hack Jul 13, 2016
profile.lua readding profile.lua Jul 2, 2013
taginfo.json Add local maxspeed for Netherland Aug 22, 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},