Install from Conda

Ananconda Install Anaconda Version Anaconda Downloads

Install the emu Conda package:

$ conda install -c birdhouse -c conda-forge emu
$ emu --help

Install from GitHub

Check out code from the Emu GitHub repo and start the installation:

$ git clone
$ cd emu

Create Conda environment named emu:

$ conda env create -f environment.yml
$ source activate emu

Install emu app:

$ pip install -e .
make install

For development you can use this command:

$ pip install -e .[dev]
$ make develop

Start Emu PyWPS service

After successful installation you can start the service using the emu command-line.

$ emu --help # show help
$ emu start  # start service with default configuration


$ emu start --daemon # start service as daemon
loading configuration
forked process id: 42

The deployed WPS service is by default available on:



Remember the process ID (PID) so you can stop the service with kill PID.

You can find which process uses a given port using the following command (here for port 5000):

$ netstat -nlp | grep :5000

Check the log files for errors:

$ tail -f  pywps.log

… or do it the lazy way

You can also use the Makefile to start and stop the service:

$ make start
$ make status
$ tail -f pywps.log
$ make stop

Run Emu as Docker container

You can also run Emu as a Docker container, see the Tutorial.

Use Ansible to deploy Emu on your System

Use the Ansible playbook for PyWPS to deploy Emu on your system.