Vector and raster maps with GL styles. Server side rendering by MapLibre GL Native. Map tile server for MapLibre GL JS, Android, iOS, Leaflet, OpenLayers, GIS via WMTS, etc.
Go to file
zstadler 50201f0a99
Add Docker Healthcheck (#636)
* Add Docker Healthcheck

Fixes #635

* Update Dockerfile_light

* Update healthcheck.js

fix healthcheck output error: "file:///usr/src/app/src/healthcheck.js:1\nvar http = require(\"http\");\n           ^\n\nReferenceError: require is not defined in ES module scope, you can use import instead\nThis file is being treated as an ES module because it has a '.js' file extension and '/usr/src/app/package.json' contains \"type\": \"module\". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.\n    at file:///usr/src/app/src/healthcheck.js:1:12\n    at ModuleJob.run (node:internal/modules/esm/module_job:193:25)\n    at async Promise.all (index 0)\n    at async ESMLoader.import (node:internal/modules/esm/loader:526:24)\n    at async loadESM (node:internal/process/esm_loader:91:5)\n    at async handleMainPromise (node:internal/modules/run_main:65:12)\n"

* update version

Co-authored-by: acalcutt <acalcutt@techidiots.net>
2022-11-06 21:30:55 -05:00
docs Extended Static-Images Endpoint (#619) 2022-10-27 22:55:46 -04:00
public Bugfix: publicUrl is not used in some urls (#605) 2022-09-30 09:18:13 -04:00
src Add Docker Healthcheck (#636) 2022-11-06 21:30:55 -05:00
test Extended Static-Images Endpoint (#619) 2022-10-27 22:55:46 -04:00
.dockerignore Move docker images to ubuntu (#620) 2022-10-05 09:11:03 -04:00
.gitattributes Add .gitattribute (#637) 2022-11-06 18:08:26 -05:00
.gitignore Experimental integration of first plugin 2016-12-06 20:11:18 +01:00
.travis.yml Update travis to node 10 2019-12-30 16:54:36 +01:00
docker-entrypoint_light.sh update docker images to work with new maplibre-native 2022-09-14 17:43:44 -04:00
docker-entrypoint.sh Move docker images to ubuntu (#620) 2022-10-05 09:11:03 -04:00
Dockerfile Add Docker Healthcheck (#636) 2022-11-06 21:30:55 -05:00
Dockerfile_light Add Docker Healthcheck (#636) 2022-11-06 21:30:55 -05:00
Dockerfile_test Move docker images to ubuntu (#620) 2022-10-05 09:11:03 -04:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md 2018-01-23 12:17:14 +01:00
LICENSE.md Create LICENSE.md 2016-06-05 16:44:27 +02:00
package-lock.json Add Docker Healthcheck (#636) 2022-11-06 21:30:55 -05:00
package.json Add Docker Healthcheck (#636) 2022-11-06 21:30:55 -05:00
publish.js Update publishing (#616) 2022-09-28 16:39:26 -04:00
PUBLISHING.md Update publishing (#616) 2022-09-28 16:39:26 -04:00
README_light.md Replace last references to the old repository/dockerhub 2020-03-11 13:57:45 +01:00
README.md Readme update (#611) 2022-09-21 23:03:22 -04:00
run.sh Resolve https://github.com/maptiler/tileserver-gl/issues/386 2020-01-28 11:29:42 +02:00

tileserver-gl

TileServer GL

Build Status Docker Hub

Vector and raster maps with GL styles. Server-side rendering by MapLibre GL Native. Map tile server for MapLibre GL JS, Android, iOS, Leaflet, OpenLayers, GIS via WMTS, etc.

Download vector tiles from OpenMapTiles.

Getting Started with Node

Make sure you have Node.js version 14.20.0 or above installed. Node 16 is recommended. (running node -v it should output something like v16.x.x). Running without docker requires Native dependencies to be installed first.

Install tileserver-gl with server-side raster rendering of vector tiles with npm.

npm install -g tileserver-gl

Once installed, you can use it like the following examples.

using a mbtiles file

wget https://github.com/maptiler/tileserver-gl/releases/download/v1.3.0/zurich_switzerland.mbtiles
tileserver-gl --mbtiles zurich_switzerland.mbtiles
[in your browser, visit http://[server ip]:8080]

using a config.json + style + mbtiles file

wget https://github.com/maptiler/tileserver-gl/releases/download/v1.3.0/test_data.zip
unzip test_data.zip
tileserver-gl
[in your browser, visit http://[server ip]:8080]

Alternatively, you can use the tileserver-gl-light npm package instead, which is pure javascript, does not have any native dependencies, and can run anywhere, but does not contain rasterization on the server side made with Maplibre GL Native.

Getting Started with Docker

An alternative to npm to start the packed software easier is to install Docker on your computer and then run from the tileserver-gl directory

Example using a mbtiles file

wget https://github.com/maptiler/tileserver-gl/releases/download/v1.3.0/zurich_switzerland.mbtiles
docker run --rm -it -v $(pwd):/data -p 8080:80 maptiler/tileserver-gl --mbtiles zurich_switzerland.mbtiles
[in your browser, visit http://[server ip]:8080]

Example using a config.json + style + mbtiles file

wget https://github.com/maptiler/tileserver-gl/releases/download/v1.3.0/test_data.zip
unzip test_data.zip
docker run --rm -it -v $(pwd):/data -p 8080:80 maptiler/tileserver-gl
[in your browser, visit http://[server ip]:8080]

Example using a different path

docker run --rm -it -v /your/local/config/path:/data -p 8080:80 maptiler/tileserver-gl

replace '/your/local/config/path' with the path to your config file

Alternatively, you can use the maptiler/tileserver-gl-light docker image instead, which is pure javascript, does not have any native dependencies, and can run anywhere, but does not contain rasterization on the server side made with Maplibre GL Native.

Getting Started with Linux cli

Test from command line

wget https://github.com/maptiler/tileserver-gl/releases/download/v1.3.0/test_data.zip
unzip -q test_data.zip -d test_data
xvfb-run --server-args="-screen 0 1024x768x24" npm test

Run from command line

xvfb-run --server-args="-screen 0 1024x768x24" node .

Documentation

You can read the full documentation of this project at https://tileserver.readthedocs.io/.

Alternative

Discover MapTiler Server if you need a map server with easy setup and user-friendly interface.