Skip to content

Installation

There are several ways to install Valhalla, depending on whether you want the HTTP service, the command line tools or the library bindings.

From source

If you want to build Valhalla from source, follow the build documentation.

With Docker

Test & Publish Docker image

To run Valhalla locally or your own server, we recommend using one of our Docker images, see the README.

Via Python bindings

pyvalhalla version

We publish our (very) high-level Python bindings to PyPI with pyvalhalla.

The Python packages don't only contain the Python bindings, they also provide access to the C++ executables, e.g. in the form of python -m valhalla valhalla_build_tiles -h. For more details, see the Python README.

To install the native C++ executables one doesn't even need to have root permissions or even have Python installed. Simply download the desired wheel from PyPI, extract it with e.g. unzip and run the included valhalla/bin/<binary> directly.

Via NodeJS bindings

npm version npm version

We provide high-level NodeJS binding:

npm install @valhallajs/valhallajs

For more details, see the NodeJS README.