xtratiler

Raster tile renderer for ldproxy.

Scope

xtratiler is an accessory for ldproxy. It polls the ldproxy job queue for raster tile jobs. When a job is found, it will render raster tiles from already existing vector tiles and a given MapLibre Style. The renderer raster tiles are written to the ldproxy store and then published by ldproxy.

Limitations

• Only stores of type FS are supported for now (see ldproxy documentation).
• Only tile caches of type DYNAMIC are supported for now (see ldproxy documentation).

Prerequisites

An ldproxy instance with at least one tile provider with a configured raster tileset is needed, see rasterTilesets in the ldproxy documentation.

Port 7081 of the ldproxy instance must be accessible for xtratiler and both ldproxy and xtratiler need access to the same store.

Installation

Here is an example of a docker-compose.yml that installs both ldproxy and xtratiler:

services:
  ldproxy:
    image: iide/ldproxy:latest
    restart: always
    ports:
      - "7080:7080"
    volumes:
      - /path/to/store:/data

  xtratiler:
    image: ghcr.io/ldproxy/xtratiler:latest
    restart: always
    command: agent -q http://ldproxy:7081 -c 32 -r 2
    volumes:
      - /path/to/store:/store

Notice that both containers mount the same store directory and that xtratiler accesses port 7081 of the ldproxy container through the private docker network, it does not have to be exposed.