cdbece5 Oct 18, 2016
@karussell @boldtrn
20 lines (14 sloc) 1.55 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 GraphHopper Server as zip (~9MB)
  2. Unzip it and copy an OSM file into the created directory. For example berlin-latest.osm.pbf
  3. Start GraphHopper Maps via: java -jar *.jar jetty.resourcebase=webapp datareader.file=berlin-latest.osm.pbf
  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.

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, 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
  • Or contact us