Requirements¶
To install a GeoMapFish application, you need to have the following components installed on your system:
- Git
- Docker >= 1.12 (>= 17 is recommended)
- Python >= 3.5
- Python-netifaces
- Apache >= 2.4 (optional, can be used as a front for SSL)
- PostgreSQL >= 9.1/PostGIS >= 2.1 in UTF-8
- gnupg (with dirmngr) optional
In addition, to start a GeoMapFish application, you need to use docker-compose
in version 1.8 or later. If docker-compose
is not installed on your system,
you can install it in your home directory by executing
python3 -m pip install --user docker-compose
and making sure the installation
directory is in your user’s path (upon first installation, you may need to log on again).
Required Apache modules¶
mod_proxy
mod_proxy_http
Additional notes for Windows users¶
Cygwin¶
- Go to https://cygwin.com/
- In the download section, download the installer corresponding to your system
- Run the downloaded installer
- Choose an install folder not containing any space or weird characters (like parentheses)
When installing Cygwin, please make sure to install the following non-default packages:
make
from thedevel
foldergettext-devel
from thedevel
folderwget
from theweb
folder
Cygwin should always be run in administrator mode. To configure that:
- Go to the Windows start menu
- Right-click the Cygwin Terminal program icon
- Open its properties
- Under the
Compatibility
tab, check theRun this program as an administrator
To avoid file permission problems between Windows and Cygwin, edit Cygwin’s
/etc/fstab
file to disable ACLs like this:
none /cygdrive cygdrive binary,noacl,posix=0,user 0 0
Configure Git¶
Cygwin comes with its own git package. Configure Cygwin’s git for Windows as follows:
- Open a Cygwin bash
- Run
git config core.autocrlf true