MBTiles File Sources

Martin can serve any type of tiles from MBTile files. MBTiles archives are local SQLite databases and must reside on the same machine as the tile server. To serve a file from CLI, simply put the path to the file or the directory with *.mbtiles files. For example:

martin  /path/to/mbtiles/file.mbtiles  /path/to/directory

You may also want to generate a config file using the --save-config my-config.yaml, and later edit it and use it with --config my-config.yaml option.

MBTiles Hot Reload

Martin watches directories configured under mbtiles for changes at runtime. When .mbtiles files are added, modified, or removed from a watched directory, Martin automatically updates the tile catalog - no restart required.

# Martin will watch this directory and reflect any *.mbtiles changes live
martin  /path/to/mbtiles/directory

Or via config file:

mbtiles:
  paths:
    - /path/to/mbtiles/directory

The following events are handled automatically:

• File added - the new source appears in the catalog.
• File modified - the source is reloaded and its tile cache is invalidated. Not avaliable on windows due to OS-limtations (SQLite not allowing FILE_SHARE_DELETE).
• File removed - the source is removed from the catalog.