OpenStreetMap-Tile-Server

Overview

A production-ready OpenStreetMap tile server running inside a single Docker container. Includes PostgreSQL, osm2pgsql, renderd, and Apache. FIRST RUN: Set Post Arguments to [import] and place your .osm.pbf file in the OSM Data path before starting. After import completes, change Post Arguments to [run] and restart. Download map data (PBF files) from https://download.geofabrik.de/

Runtime arguments

Web UI: http://[IP]:[PORT:80]/
Network: bridge
Shell: bash
Privileged: false

Template configuration

Web UI PortPorttcp

HTTP port for tile server and slippy map demo.

Target: 80
Default: 8080
Value: 8080

Database StoragePathrw

PostgreSQL database storage. Requires significant disk space depending on region size.

Target: /data/database/
Default: /mnt/user/appdata/osm-tile-server/database
Value: /mnt/user/appdata/osm-tile-server/database

Tile CachePathrw

Rendered map tile cache storage.

Target: /data/tiles/
Default: /mnt/user/appdata/osm-tile-server/tiles
Value: /mnt/user/appdata/osm-tile-server/tiles

OSM Data (PBF Import)Pathro

Path to your .osm.pbf file downloaded from Geofabrik. Only needed on first run (import mode).

Target: /data/region.osm.pbf
Default: /mnt/user/appdata/osm-tile-server/data/region.osm.pbf
Value: /mnt/user/appdata/osm-tile-server/data/region.osm.pbf

Custom StylePathrw

Optional: Mount a custom CartoCSS/Mapnik style directory.

Target: /data/style/
Default: /mnt/user/appdata/osm-tile-server/style
Value: /mnt/user/appdata/osm-tile-server/style

Osmosis State (Live Updates)Pathrw

Required only if UPDATES is set to enabled.

Target: /data/osmosis/
Default: /mnt/user/appdata/osm-tile-server/osmosis
Value: /mnt/user/appdata/osm-tile-server/osmosis

Render ThreadsVariable

Number of threads used for rendering tiles. Match to your CPU core count.

Target: THREADS
Default: 4
Value: 4

Live OSM UpdatesVariable

Set to [enabled] to keep the map updated via OSM diffs. Requires the Osmosis path to be set.

Target: UPDATES
Default: disabled
Value: disabled

Allow CorsVariable

Set to 1 to enable CORS headers (useful when embedding tiles in web apps).

Target: ALLOW_CORS
Default: 1
Value: 1

Links

Template Support Docker Hub Project

Details

Repository

overv/openstreetmap-tile-server

Registry

https://hub.docker.com/r/overv/openstreetmap-tile-server

Last Updated2025-11-10

First Seen2026-03-29

Run OpenStreetMap-Tile-Server on Unraid.

OpenStreetMap-Tile-Server is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS