MapProxy is an open source proxy for geospatial data. It caches, accelerates and transforms data from existing map services and serves any desktop or web GIS client.
MapProxy is a tile cache, but also offers many new and innovative features like full support for WMS clients.
MapProxy is released under the Apache Software License 2.0, runs on Unix/Linux and Windows and is easy to install and to configure.
Go to https://mapproxy.org/ for more information.
The documentation is available at: http://mapproxy.github.io/mapproxy/latest/
Changes
7.0.0 2026-07-17
Breaking:
Security Fix: Avoiding path traversals in dimensions parameter. In rare cases, existing cache directories will not be reused and created newly with safe directory names
Maintenance:
Raising python version in workflows and docker images to 3.14
Update dependencies
Fixes:
Error with transparent PNGs in mixed format
6.1.1 2026-06-17
Maintenance:
Update dependencies
Fixes:
ImageResult.as_buffer will always return image mode rgba if requested
Restore context manager protocol on ProxyConfiguration
Fix base path for rendering OGC API HTML pages in multi mapproxy setups
Fix determination of resolutions in WMTS demo
6.1.0 2026-06-03
Maintenance:
Add static typing
Update action versions
Post coverage report in PRs
Update pillow versions in actions
Replace tox.ini with pyproject.toml
Update docs
Add architecture diagrams
Update various dependencies
Refactored code to clarify and use types
Refactored ImageSource to ImageResult
Split loader.py into multiple files
Remove support for python 3.9 (EOL)
Fixed shapely deprecation warnings
Improvements:
Add json GFI format
Improve configuration validation
Improvements for reverse proxy setups
Improve multi processing in tests
XML / HMTL errors in GFI requests are handled in a more lenient way now. Instead of raising exceptions on bad input, the code now logs warnings and returns safe empty defaults.
Feature: Update OpenLayers and use OGCMapTile source in OGC-API demo pages
Use environment variables in yaml-files for storing sensitve data
Fixes:
Bug fixes in OGC APIs
Fix seeding worker crash on incomplete HTTP responses
Catch sqlite3.DatabaseErrors for all cursor actions
Wrap IOError as LockError in LockFile.__init__ to enable retry on race condition
6.0.1 2025-10-29
Maintenance:
Removed code to be able to start up MapProxy without PIL.
Fixes:
Add python-dateutil dependency to avoid errors on startup.
Add ogcapi to config-schema.json to avoid warnings on startup.
6.0.0 2025-10-22
Breaking:
The extension for mbtiles used in MapProxy was wrong. It used .mbtile instead of .mbtiles. Existing files in caches have to be renamed! Here is a small script to change all files in a directory recursively: find . -type f -name “*.mbtile” -exec sh -c ‘mv “$1” “${1%.mbtile}.mbtiles”’ _ {} ;
lxml was updated. The new version is much stricter in its inputs and administrators might have to adjust featureinfo services to output valid HTML.
Improvements:
New source types ogcapitiles and ogcapimaps are now available! See docs for further information.
New util gridconf-from-ogcapitilematrixset to fetch grids from an OGC API compliant web service was added. See docs for further information.
MapProxy now offers an OGCAPI compliant service for OGC API Maps and OGC API Tiles. Including landing page and preview maps! See docs for further information.
The SERVICE parameter for WMS GetMap requests is no longer mandatory as according to spec.
Added test pipeline for the documentation.
The GitHub actions now have better fitting permissions, improving the security.
WMTS capabilities now include OperationsMetadata for restful mode.
TMS capabilities now include metadata similar to WMS and WMTS.
Maintenance:
Some fixes in the documentation.
As shapely is no longer optional, code to check for its existence has been removed.
Fixes:
An error regarding unicode strings in the featureinfo parsing was fixed.
An error in the debug logging of configurations was fixed
5.1.1 2025-10-01
Improvements:
Better logging of http errors if mapproxy requests tiles
Fixes:
Fixed logger for merged configuration files
5.1.0 2025-09-30
Improvements:
Added query_layers option to wms_opts to be able to configure the QUERY_LAYERS of the wms request
Added workflow to republish docker images if the base image changed, i.e. for security updates
Maintenance:
Fixed some spelling and debug output
Updated various dependencies
Fixes:
Fixes some errors in the json schema regarding use_direct_level_from and use_direct_res_from
Fixes an error with merging resolutions of grids
Older changes
See https://raw.github.com/mapproxy/mapproxy/master/CHANGES.txt
Release files for MapProxy 7.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mapproxy-7.0.0.tar.gz | 3.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mapproxy-7.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.3 MB
Release files / mapproxy-7.0.0.tar.gz
| Download URL | mapproxy-7.0.0.tar.gz |
|---|---|
| Size | 3.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
43c4972d98a01b04a2887f88eda5ad74e527233ad8fd01fd943a541907465d56
|
|
BLAKE2b-256 checksum How to use checksums |
61e16c490f14d9f34ea94938d48d544c186ab49699c3ade9fe9f14518e6f2622
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency logRelease files / mapproxy-7.0.0-py3-none-any.whl
| Download URL | mapproxy-7.0.0-py3-none-any.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
319026e1a2d4ad4b6ad150fc2db474a9acf312a20bb71634029147d730cc1fdb
|
|
BLAKE2b-256 checksum How to use checksums |
35c57f5065b5612e8baf044b038f22157bacbcac561c6740c8ef69cf87b373a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 17, 2026.
Transparency log
