26 lines (20 sloc) 1.84 KB


If you want to build GraphHopper from source look at the Developers page. The following steps are simpler and only need the JRE, a jar file and an OSM file.

  1. Install the latest JRE and get the GraphHopper Web Service as jar file
  2. Copy an OSM file to the same directory. For example berlin-latest.osm.pbf
  3. Start GraphHopper Maps via:
    java -Dgraphhopper.datareader.file=berlin-latest.osm.pbf -jar *.jar server config-example.yml
  4. After you see 'Started server at HTTP 8989' go to http://localhost:8989/ and you should see a map of Berlin. You should be able to click on the map and a route appears.

See here how to easily enable elevation data. To see how GraphHopper is configured for production usage, see the deployment guide.


  • Make sure JRE8 is installed. If not get Java here.
  • Regarding step 2:
    • The folder where you execute the java command should contain the following files: berlin-latest.osm.pbf, config-example.yml and graphhopper-web-[version].jar
    • The first time you execute this it'll take ~30 seconds (for Berlin), further starts will only load the graph and should be nearly instantaneous. You should see log statements but no exceptions and the last entry should be something like: Started server at HTTP 8989
  • Regarding step 3:
    • Depending on the size of the map you might run into java.lang.OutOfMemoryError. In this case you need to increase the memory settings of the JVM by starting the above command with java -Xmx2g -Xms2g ... (example for 2GB memory)
  • Or contact us