maplibre/martin

Martin is a tile server and a set of tools able to generate vector tiles on the fly from large PostgreSQL databases and GeoJSON files, and serve tiles from PMTiles and MBTiles files. It can also serve vector tiles from GeoParquet files via DuckDB (unstable). Martin optimizes for speed and heavy traffic, and is written in Rust.

Features

• Serve vector tiles from
  • PostGIS databases, automatically discovering compatible tables and functions
  • PMTile, both local files and over HTTP
  • MBTile files
  • GeoJSON files, converted to vector tiles on the fly
  • GeoParquet files via DuckDB, converted to vector tiles on the fly (unstable)
• Passthrough tiles from an upstream HTTP tile server
• Combine multiple tile sources into one
• Serve styles and generate sprites or font glyphs on the fly
• Generate tiles in bulk from any Martin-supported sources into an MBTiles file with the martin cp subcommand
• Examine, copy, validate, compare, and apply diffs between MBTiles files with mbtiles tool

Documentation

• Quick Start
• Installation
• Running with CLI or configuration file
• Usage and API

Getting Involved

Join the #maplibre-martin slack channel at OSMUS -- automatic invite is at https://slack.openstreetmap.us/

Contributing

Like any open source project, Martin welcomes contributions from anyone who wants to help improve it.

• See Development Guide for setup
• Use just help for common commands
• Check help wanted issues

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.