layout: default title: Installation permalink: /installation/

Installation

In order to run Baremaps, you first need to install Java 8 or a later version. SDKMAN provides a convenient Command Line Interface (CLI) to install and upgrade Java.

To install baremaps, download and unzip the latest release. Then, add the /bin folder to your PATH variable:

wget https://github.com/baremaps/baremaps/releases/latest/download/baremaps.zip
unzip baremaps.zip
export PATH=$PATH:`pwd`/baremaps/bin

Calling the baremaps command should now result in an output similar to the following:

Usage: baremaps [COMMAND]
A toolkit for producing vector tiles.
Commands:
  import  Import OpenStreetMap data in the Postgresql database.
  update  Update OpenStreetMap data in the Postgresql database.
  export  Export vector tiles from the Postgresql database.
  serve   Serve vector tiles from the the Postgresql database.

In order to run Baremaps, you need to setup a postgis database. The following docker image will allow you to jump start this installation:

docker run \
  --name baremaps \
  --publish 5432:5432 \
  -e POSTGRES_DB=baremaps \
  -e POSTGRES_USER=baremaps \
  -e POSTGRES_PASSWORD=baremaps \
  -d postgis/postgis:latest

You can then stop and start the container with the following commands:

docker stop baremaps
docker start baremaps

From there, the OpenStreetMap example is a good introduction to Baremaps, it shows how to produce high resolution vector tiles.