Installation on Windows

At frist you need a working Python installation. You can download Python from: MapProxy requires Python 2.5, 2.6 or 2.7, it is not compatible with Python 3.

We advise you to install MapProxy into a virtual Python environment. Read about virtualenv if you want to now more about the benefits.

A self-contained version of virtualenv is available at:

To create a new virtual environment for our proxy installation and to activate it go to the command line and call:

C:\Python27\python path\to\ c:\mapproxy_venv


The last step is required every time you start working with your MapProxy installation. Alternatively you can always explicitly call \mapproxy_venv\Scripts\<command>.


Apache mod_wsgi does not work with virtualenv on Windows. If you want to use mod_wsgi for deployment, then you should skip the creation the virtualenv. You need to install the distribute package to get the easy_install command.

After you activated the new environment, you have access to python and easy_install. To install MapProxy with most dependencies call:

easy_install MapProxy

This might take a while.

Since libproj4 is generally not available on a Windows system, you will also need to install the Python package pyproj.

easy_install pyproj

Platform dependent packages

All Python packages are downloaded from, but not all platform combinations might be available as a binary package, especially if you run a 64bit version of Windows.

If you run into troubles during installation, because it is trying to compile something (e.g. complaining about vcvarsall.bat), you should look at Christoph Gohlke’s Unofficial Windows Binaries for Python Extension Packages.

You can install the .exe packages with easy_install:

easy_install path\to\package-xxx.exe

Check installation

To check if the MapProxy was successfully installed you can call mapproxy-util. You should see the installed version number.

mapproxy-util --version

Now continue with Create a configuration from the installation documentation.