install

Additional install commands

macOS

Homebrewverified · 100%

brew install pmtiles

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#pmtiles

nixpkgs package indexes · pkgs/by-name/pm/pmtiles/package.nix · source: api.github.com

overview

Package summary

Single-file executable tool for creating, reading and uploading PMTiles archives

Project links

Commands and aliases

pmtiles

history

Project history and usage

PMTiles is an open, single-file archive format for tiled map data and a companion Go command-line tool for inspecting, converting, extracting, serving, and uploading those archives.

Project history

Protomaps introduced PMTiles as an open single-file archive format for tiled data. The reference implementations carry a BSD 3-Clause license, while the specification is public domain or CC0 where applicable. Version 3 is the current documented format generation.

Adoption history

PMTiles has been integrated into the broader web-mapping toolchain: official material documents clients for MapLibre, Leaflet, OpenLayers, Go, JavaScript, and Python, while Tippecanoe 2.17 and later can write PMTiles directly. The format is designed for deployment on ordinary HTTP servers and object stores such as S3-compatible services.

How it is used

The pmtiles CLI can inspect local or remote archives, verify structure, extract geographic or zoom subsets, merge and cluster archives, convert MBTiles, serve Z/X/Y endpoints, edit metadata, and upload files to cloud storage. Private cloud access uses each provider's default authentication, such as AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY for S3-compatible services.

Why package nerds care

PMTiles turns a tiled map pyramid into one seekable file, replacing large directory trees and specialized tile backends with HTTP Range requests against static storage. For packaging and infrastructure enthusiasts, the appeal is a dependency-free CLI and a serverless deployment model with few moving parts.

Timeline

2021: The official PMTiles repository records Protomaps copyright beginning in 2021.
Version 3: PMTiles adopted its current documented archive specification.
Tippecanoe 2.17: Direct PMTiles output became supported by the established vector-tile generator.

Related projects

Official documentation connects PMTiles with MBTiles, Tippecanoe, MapLibre, Leaflet, OpenLayers, Rasterio/rio-pmtiles, cloud object storage, and Protomaps basemaps.

Sources

Official CLI documentation: https://docs.protomaps.com/pmtiles/cli
Official PMTiles repository and specification: https://github.com/protomaps/PMTiles
Official Protomaps documentation: https://docs.protomaps.com/pmtiles
Official creation guide: https://docs.protomaps.com/pmtiles/create

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:upload,archive

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`pmtiles`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-09-19

manager version1.31.2

manager updated2026-09-11

local dataok

upstreamcurrent

latest detectedv1.31.2

https://github.com/protomaps/go-pmtiles

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:pmtiles
Version	1.31.2
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/pmtiles
Homepage	https://protomaps.com/docs/pmtiles
Repository	https://github.com/protomaps/go-pmtiles
Upstream docs	https://protomaps.com/docs/pmtiles
License	BSD-3-Clause
Source archive	https://github.com/protomaps/go-pmtiles/archive/refs/tags/v1.31.2.tar.gz
Last updated	2026-09-11T13:20:26Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	pmtiles
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

pmtiles

nix profile install nixpkgs#pmtiles

normalized package name match
Matched by: Pmtiles

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/pm/pmtiles/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/pmtiles.yml

Used sources

Geiger risk classifier
cross-ecosystem install command graph
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment
pkg.so package database
pkgdb category and tag curation

Install pmtiles with Homebrew, Nix