From 868d51439441a25e44e7ab1269c018f3c8082022 Mon Sep 17 00:00:00 2001 From: "Daniel J. H." Date: Fri, 18 Oct 2024 11:55:44 +0200 Subject: [PATCH] Adds documentation on how to use config paths with docker, closes #720 (#722) --- README.md | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 85e88bc7..2a0ffcbe 100644 --- a/README.md +++ b/README.md @@ -12,9 +12,8 @@ See an example of a vector tile map produced by tilemaker at [tilemaker.org](htt We provide a ready-to-use docker image that gets you started without having to compile tilemaker from source: -1. Go to http://download.geofabrik.de/europe.html and download the `monaco-latest.osm.pbf` snapshot of OpenStreetMap - -2. Run tilemaker on the OpenStreetMap snapshot to generate [Protomaps](https://protomaps.com) vector tiles: +1. Go to [Geofabrik](http://download.geofabrik.de/europe.html) and download the `monaco-latest.osm.pbf` snapshot of OpenStreetMap +2. Run tilemaker on the OpenStreetMap snapshot to generate [Protomaps](https://protomaps.com) vector tiles (see below) ``` docker run -it --rm -v $(pwd):/data ghcr.io/systemed/tilemaker:master /data/monaco-latest.osm.pbf --output /data/monaco-latest.pmtiles @@ -22,6 +21,27 @@ We provide a ready-to-use docker image that gets you started without having to c 3. Check out what's in the vector tiles e.g. by using the debug viewer [here](https://protomaps.github.io/PMTiles/) +To run tilemaker with its default configuration + +```bash +docker run -it --rm --pull always -v $(pwd):/data \ + ghcr.io/systemed/tilemaker:master \ + /data/monaco-latest.osm.pbf \ + --output /data/monaco-latest.pmtiles +``` + +To run tilemaker with a custom configuration using coastlines and landcover you have two options +1. In the config.json use absolute paths such as `/data/coastline/water_polygons.shp` or +2. Set the docker workdir `-w /data` with relative paths `coastline/water_polygons.shp` (see below) + +```bash +docker run -it --rm --pull always -v $(pwd):/data -w /data \ + ghcr.io/systemed/tilemaker:master \ + /data/monaco-latest.osm.pbf \ + --output /data/monaco-latest.pmtiles \ + --config /data/config-coastline.json \ + --process /data/process-coastline.lua +``` ## Installing