VersaTiles Docker

Docker images for VersaTiles - a fast map tile server. This repository contains Dockerfiles and GitHub workflows for building and publishing production-ready Docker images.

Quick Start

Get up and running in seconds:

# Pull and run a map server with web frontend
docker run -p 8080:8080 -v $(pwd):/data \
  versatiles/versatiles-frontend:latest osm.versatiles

Open http://localhost:8080/ in your browser to view your map.

Prerequisites

• Docker installed (Get Docker)

Which Image Should I Use?

Image	Use Case	When to Choose
versatiles-frontend	Map server with web interface	Best for most users - includes everything you need to serve and view maps
versatiles	Just the binary	You only need the CLI tool or want the smallest possible image
versatiles-nginx	Production deployment	You need TLS/SSL, caching, reverse proxy, or Let's Encrypt certificates
versatiles-gdal	Convert geodata formats	You're working with geospatial data formats (GeoTIFF, Shapefile, etc.)
versatiles-tilemaker	Generate tiles from OSM	You want to create custom map tiles from OpenStreetMap data
versatiles-tippecanoe	Generate vector tiles	You need to convert GeoJSON to vector tiles

Images

Getting Started

versatiles

Minimal image containing only the versatiles binary.

• Supported OS: Alpine, Debian, Scratch
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Alpine
Scratch
Debian

Example usage:

# Download and crop map data to Paris
docker run -it --rm -v $(pwd):/data versatiles/versatiles:latest \
  convert --bbox-border 3 --bbox "2.224,48.815,2.47,48.903" \
  "https://download.versatiles.org/osm.versatiles" "paris.versatiles"

versatiles-frontend

Map server bundled with the versatiles-frontend web interface.

• Contains: versatiles + web frontend
• Supported OS: Alpine, Debian, Scratch
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Alpine
Scratch
Debian

Example usage:

# Serve tiles with web interface
docker run -d -p 8080:8080 -v $(pwd):/data:ro \
  versatiles/versatiles-frontend:latest osm.versatiles

Production

versatiles-nginx

Production-ready setup with nginx reverse proxy and automatic Let's Encrypt SSL certificates via certbot.

• Contains: versatiles + nginx + certbot
• Supported OS: Alpine
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Alpine

Tile Generation

versatiles-gdal

VersaTiles combined with GDAL for working with geospatial data formats.

• Contains: versatiles + GDAL
• Supported OS: Debian
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Debian

versatiles-tilemaker

Generate vector tiles from OpenStreetMap data using tilemaker.

• Contains: versatiles + tilemaker + helper tools (aria2, curl, GDAL, osmium)
• Supported OS: Debian
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Debian

versatiles-tippecanoe

Create vector tiles from GeoJSON using Felt's tippecanoe.

• Contains: versatiles + tippecanoe
• Supported OS: Alpine
• Architectures: AMD64, ARM64
• Registries: GitHub Container Registry | Docker Hub
• Documentation: Detailed README

OS	Version	Image Size
Alpine

Documentation

• VersaTiles Server: versatiles-rs - The core tile server implementation
• Web Frontend: versatiles-frontend - Interactive map viewer
• Tile Data: download.versatiles.org - Pre-built tile datasets

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Support

• Issues: GitHub Issues
• Main Project: VersaTiles Organization

License

Distributed under the MIT License. See individual image directories for more details.