Skip to content

A minimal http server with mbtiles (SQLite) raster and vector tiles support.

Notifications You must be signed in to change notification settings


Repository files navigation


Build Status Coverage Status Open Source Love MIT Licence PRs Welcome code style: prettier


Demo: tiny-tileserver

tiny-tileserver is a minimal raster and vector tile server. It supports .mbtiles containing rasters of .png, .jpg and vector tiles in .pbf protobuf format.


  • Supports thousands of tile sets
  • Vector tiles (MBTiles)
    • Serve protobuf .pbf vector tiles
    • Compressed (deflate, gzip) or uncompressed tiles
    • Can convert to .geosjon
    • Return semi-raw protobuf as json (integer coordinates)
  • Raster tiles (MBTiles)
    • Serve png or jpg raster tiles
  • Static files
    • Can serve any other file statically


Put one or more .mbtiles inside the data subfolder.


yarn start

Navigate to http://localhost:8000/ to display a summary of the tile sets.

Tiles can be pulled using an url of this form: http://localhost:8000/{name}/{zoom}/{x}/{y}


Tiny-tileserver has command-line options:

Usage: node tiny-tileserver.js [options] [rootDirectory]

rootDirectory    Data directory containing .mbtiles

   -p PORT --port PORT       Set the HTTP port [8000]

A root directory is required.


The following images are built for each tiny-tileserver release, using the Node.js base image.

Docker image

To use prebuilt docker image, navigate to a folder containing .mbtile file(s) and run

docker run -v ${pwd}:/data -p 8000:8000 artsdatabanken/tiny-tileserver