Installation¶
Docker¶
When running docker image, no special installation is needed – the docker will automatically download the image if not present.
Just run docker run --rm -it -v $(pwd):/data -p 8080:8080 maptiler/tileserver-gl.
Additional options (see Usage) can be passed to the TileServer GL by appending them to the end of this command. You can, for example, do the following:
docker run ... maptiler/tileserver-gl --file my-tiles.mbtiles– explicitly specify which mbtiles to use (if you have more in the folder)docker run ... maptiler/tileserver-gl --verbose– to see the default config created automatically
npm¶
npm is supported on the following platforms with Native Dependencies installed.
Operating systems:
Ubuntu 22.04 (x64/arm64)
macOS 14 (x64/arm64)
Windows (x64)
Node.js 18(>=18.17.0),20,22
Install globally from npmjs.¶
npm install -g tileserver-gl tileserver-gl Install locally from source¶
git clone https://github.com/maptiler/tileserver-gl.git cd tileserver-gl npm install node . Native dependencies¶
Ubuntu 22.04 (x64/arm64)¶
apt install build-essential pkg-config xvfb libglfw3-dev libuv1-dev libjpeg-turbo8 libicu70 libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev gir1.2-rsvg-2.0 librsvg2-2 librsvg2-common libcurl4-openssl-dev libpixman-1-dev libpixman-1-0
MacOS 14 (x64/arm64)¶
brew install pkg-config cairo pango libpng jpeg giflib librsvg harfbuzz
Windows (x64)¶
tileserver-gl-light on npm¶
Alternatively, you can use tileserver-gl-light package instead, which is pure javascript (does not have any native dependencies) and can run anywhere, but does not contain rasterization features.