Installation
Install from PyPI
Note
As of Summer 2025, raven is available as a PyPI-based package for testing and evaluation purposes. For a production server, we recommend deploying Raven as a Docker service.
To install the latest release from PyPI:
$ python -m pip install birdhouse-raven
Install from Conda-Forge
Create an Anaconda environment named ravenwps-env:
conda env create -n ravenwps-env python=3.10
source activate ravenwps-env
This should now prepend the environment to your shell commands (i.e. (ravenwps-env) $). Now install directly from conda-forge:
(ravenwps-env) conda install -c conda-forge raven-wps
Install from GitHub
Check out code from the Raven GitHub repo and start the installation:
git clone https://github.com/Ouranosinc/raven.git
cd raven
Install from Docker
The easiest way to deploy Raven is to use the Docker image. The Docker image is available on Docker Hub as pavics/raven.
$ docker pull pavics/raven:latest
Installing and Launching RavenWPS
Now we can install the raven-wps service:
pip install -e .Or, alternatively:
make install
For development you can use this command:
pip install -e .[dev]
Or, alternatively:
make develop
Start Raven PyWPS service
After successful installation you can start the service using the raven command-line:
(ravenwps-env) $ raven-wps --help # show help (ravenwps-env) $ raven-wps start # start service with default configurationOr, alternatively:
(ravenwps-env) $ raven-wps start --daemon # start service as daemon loading configuration forked process id: 42
The deployed WPS service is by default available on:
http://localhost:9099/wps?service=WPS&version=1.0.0&request=GetCapabilities.
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:
(ravenwps-env) make start
(ravenwps-env) make status
(ravenwps-env) tail -f pywps.log
(ravenwps-env) make stop