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:\Python26\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.


If you put you virtual environment in a directory that contains a space in the name (e.g. “Documents and Settings” or “Program Files”), you will not be able to use the --reload option of paster unless you install the appropriate win32api module.

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 some minutes.

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

easy_install pyproj

To check if the MapProxy was successfully installed you can directly call the version module. You should see the installed version number.

python -m mapproxy.version

Now continue with Create a configuration from the installation documentation.