Skip to content

getting_start_local

Jump to bottom
Steffen Exler edited this page Aug 5, 2020 · 1 revision

Getting Up and Running Locally With Docker

The steps below will get you up and running with a local development environment. All of these commands assume you are in the root of your generated project.

Prerequisites

For developing with Docker it is recommended to use Linux or Mac OS. On Windows systems there a same problems but it works.

Install

Create a new directory and execute all commands in the new directory.

Download the MapnikTileServer & openstreetmap-carto.

$ git clone git@github.com:OpenHistoricalDataMap/MapnikTileServer.git
$ git clone git@github.com:OpenHistoricalDataMap/openstreetmap-carto.git

Go to the MapnikTileServer and build all images.

$ cd MapnikTileServer
$ docker-compose -f local.yml build

Download the shape files.

$ docker-compose -f local.yml run --rm django /get-shapefiles.sh

Create the base mapnik style XML.

$ docker-compose -f local.yml run --rm django python manage.py create_style_xml

Start the postgres server and create the mapnik tables.

$ docker-compose -f local.yml up -d postgres
$ docker-compose -f local.yml run --rm django python manage.py migrate

Create a demo OHDM database.

$ docker-compose -f local.yml up test-database

Convert the OHDM data into mapnik tables (osm2pgsql).

$ docker-compose -f local.yml run --rm django python manage.py ohdm2mapnik

Start celery worker & beat.

$ docker-compose -f local.yml up -d celerybeat celeryworker

Start the django web server.

$ docker-compose -f local.yml up django

Now http://localhost:8000/2020/01/01/0/0/0/tile.png should show the world mapnik as depicted below.

world map

To check if the demo data was set up right, go to http://localhost:8000/YEAR/MONTH/DAY/11/57/1134/tile.png. And change YEAR, MONTH & DAY to your current day. For example the like for the 2020-05-27 will be http://localhost:8000/2020/05/27/11/57/1134/tile.png The result should look like the tile below.

niue

Clone this wiki locally