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 24.04 (x64/arm64)

  • macOS 15 (x64/arm64)

  • Windows (x64)

• Node.js 20,22,24

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 24.04 (x64/arm64)

• apt install build-essential python3-setuptools pkg-config xvfb libglfw3-dev libuv1-dev libjpeg-turbo8 libicu-dev libcairo2-dev libpango1.0-dev libpng-dev libjpeg-dev libgif-dev librsvg2-dev librsvg2-dev libcurl4-openssl-dev libpixman-1-dev

MacOS 15 (x64/arm64)

• brew install pkg-config cairo pango libpng jpeg giflib librsvg harfbuzz

Windows (x64)

• Microsoft Visual C++ Redistributable

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.