Installing MapFish from source

This page gives the steps to installing MapFish SVN trunk.

Creating the virtual environment

MapFish is typically installed in a virtual Python environment.

To create the virtual environment download http://www.mapfish.org/downloads/virtualenv-1.3.4.py, and do:

$ python virtualenv-1.3.4.py --no-site-packages env

Now activate the virtual environment with:

$ source env/bin/activate

Your shell prompt should now look like:

(env) $

Installing the server

Start by checking out the server, see Download Svn. Once done change directory to server and run:

(env) $ python setup.py develop --index-url=http://www.mapfish.org/downloads/all/pkg --allow-hosts=www.mapfish.org

Check that everything is correctly installed by running:

(env) $ paster create --list-templates

The output should look like:

Available templates:
  basic_package:   A basic setuptools-enabled package
  mapfish:         MapFish application template
  paste_deploy:    A web application deployed through paste.deploy
  pylons:          Pylons application template
  pylons_minimal:  Pylons minimal application template

Note the mapfish line.

Installing the client plugin

Start by checking out the plugin, see Download Svn. Once done change directory to plugin-client and run:

(env) $ python setup.py develop --index-url=http://www.mapfish.org/downloads/all/pkg --allow-hosts=www.mapfish.org

Check that everything is correctly installed by running:

(env) $ paster create --list-templates

The output should look like:

Available templates:
  basic_package:   A basic setuptools-enabled package
  mapfish:         MapFish application template
  mapfish_client:  MapFish client plugin template
  paste_deploy:    A web application deployed through paste.deploy
  pylons:          Pylons application template
  pylons_minimal:  Pylons minimal application template

Note the mapfish_client line.