osm2vectortiles/tileserver
Manuel Roth a3f7181854 Handle case when a directory with the tm2 project is mounted to the /data volume, but the directory still does not contain a tm2 project 2015-09-26 17:07:12 +02:00
..
screenshots Improved screenshots 2015-09-23 14:20:30 +02:00
.dockerignore Make sure tileserver runs smoothly with kitematic 2015-09-23 14:16:55 +02:00
Dockerfile Install missing fonts for OSM Bright 2015-09-25 10:04:59 +02:00
README.md Correct docker image names in README 2015-09-25 09:20:15 +02:00
run.sh Handle case when a directory with the tm2 project is mounted to the /data volume, but the directory still does not contain a tm2 project 2015-09-26 17:07:12 +02:00
test.sh Make test output less verbose 2015-09-23 15:51:44 +02:00

README.md

Tileserver

Render raster data from vector tiles and style projects on the fly with the help of tessera.

You plug in your own vector tiles and style projects and get a raster tile server.

Kitematic Usage

Start a new container by searching for osm2vectortiles/tileserver. The container will complain about missing tm2 style projects.

Container started unsucessfully

Mount your mbtiles files and tm2 style projects into the /data volume.

Configured volumes for container

Now restart the container. You should be up and running serving generated raster tiles.

Container running and serving tiles

Docker Usage

Assuming you are in the folder containing your mbtiles files and tm2 style projects.

docker run -p 80:80 -v $(pwd):/data osm2vectortiles/tileserver

Visit localhost:80 to see a leaflet map of the rendered raster tiles.

Vector Tiles Source Configuration

The tileserver is meant to server the tiles from your own vector tiles. You can develop your stylesheet with a local tm2source source or a mapbox source but once you serve the tiles you need to reference a mbtiles source.

If you have a mbtiles file named the same as your tm2 project in the data directory, the server will automatically replace your previous source with a new source.

Given the current folder contains the following files and directories.

├── countries.tm2
└── countries.mbtiles

The original source mapbox:///klokantech.97cbd1e1 in the project.yml will now be replaced with mbtiles:///data/countries.mbtiles.

Test

Run test.sh to execute and test the tileserver container with the vector-tiles-sample project.