Skip to content

Protomaps is designed for simple CDN deployment, to turn your tilesets from these URLs:

To these URLs:{z}/{x}/{y}.mvt{z}/{x}/{y}.png{z}/{x}/{y}.mvt{z}/{x}/{y}.png

These installation guides should take less than one hour to deploy.


  • Serve tilesets to the web securely from private storage buckets.

  • Cache tiles at the edge for the fastest response to users, taking advantage of global CDN presence. Single-region buckets can have multi-second latencies for users far away; CDN cache hits can respond in 100 millisconds or less.

  • Backwards compatibility with existing map clients that use Z/X/Y map URLs.

  • Affordable costs at scale. There are no servers to maintain for AWS and Cloudflare deployments, and you pay nothing if there's no traffic.


A CDN deployment of Protomaps has three parts:

  • The data: a storage bucket containing PMTiles archives.

  • A serverless function that decodes incoming URLs into ranges and returns the tile bytes.

  • A edge network that caches the responses from serverless functions.

Next steps


featurestatic pmtilesCloudflareAWSCaddypmtiles serve
Z/X/Y compatible
edge cachingWith CDNWith CDN
SSLWith reverse proxy
scale to zero5 USD

An open source mapping system released under the BSD and ODbL licenses.