Skip to main content

A Buildout recipe to install and configure Adaguc Web Map Service with Anaconda.

Project description


birdhousebuilder.recipe.adagucserver is a Buildout recipe to install and configure Adagucserver with Anaconda. Adagucserver is an implementation of a Web Map Service (WMS). Adagucserver will be deployed as a Supervisor service and is available on a Nginx web server.

This recipe is used by the Birdhouse project.


The recipe requires that Anaconda is already installed. It assumes that the default Anaconda location is in your home directory ~/anaconda. Otherwise you need to set the ANACONDA_HOME environment variable or the Buildout option anaconda-home.

It installs the adagucserver package from a conda channel in a conda environment named birdhouse. The location of the birdhouse environment is .conda/envs/birdhouse. It deploys a Supervisor configuration for Adagucserver in ~/.conda/envs/birdhouse/etc/supervisor/conf.d/adagucserver.conf. Supervisor can be started with ~/.conda/envs/birdhouse/etc/init.d/supervisor start.

The recipe will install the nginx package from a conda channel and deploys a Nginx site configuration for Adagucserver. The configuration will be deployed in ~/.conda/envs/birdhouse/etc/nginx/conf.d/adagucserver.conf. Nginx can be started with ~/.conda/envs/birdhouse/etc/init.d/nginx start.

By default Adagucserver will be available on http://localhost:9002?service=WMS&version=1.3.0&request=GetCapabilities.

The recipe depends on:

  • birdhousebuilder.recipe.conda
  • birdhousebuilder.recipe.supervisor
  • birdhousebuilder.recipe.nginx

Supported options

The recipe supports the following options:


Buildout option with the root folder of the Anaconda installation. Default: $HOME/anaconda. The default location can also be set with the environment variable ANACONDA_HOME. Example:

export ANACONDA_HOME=/opt/anaconda

Search priority is:

  1. anaconda-home in buildout.cfg
  3. $HOME/anaconda
Title of the Web Map Service. Default: Birdhouse ADAGUC WMS
Description of the Web Map Service. Default: ADAGUC Web Map Service used in Birdhouse
Port used by the Adaguc WMS service. Default: 9002
Path to the data directory with NetCDF files. Default: ~/.conda/envs/birdhouse/var/lib/pywps/outputs
Enabled caching of WMS requests. Default: false

Example usage

The following example buildout.cfg installs Adagucserver with Anaconda:

parts = adaguc

anaconda-home = /home/myself/anaconda

recipe = birdhousebuilder.recipe.adagucserver
port = 9002

After installing with Buildout start the Adagucserver WMS service with:

$ cd /home/myself/.conda/envs/birdhouse
$ etc/init.d/supervisord start  # start|stop|restart
$ etc/init.d/nginx start        # start|stop|restart
$ bin/supervisorctl status      # check that adagucserver is running
$ less var/log/adaguc.log  # check log file

Open your browser with the following URL:


Run a GetCapabilites with an OpenDAP source:



Carsten Ehbrecht ehbrecht at

Change History

0.3.4 (2015-12-07)

  • using latest supervisor recipe.

0.3.3 (2015-11-12)

  • fixed output parsing in wsgi wrapper.

0.3.2 (2015-11-12)

  • updated to adagucserver 1.9.6.
  • renamed template autowms.xml to adaguc.autoresource.xml.
  • disabled cascaded base wms layers in template.

0.3.1 (2015-10-21)

  • added more options: title, abstract, enablecache
  • fixed handling of xml output of adagucserver in wsgi appliation
  • cleaned up configs
  • updated readme

0.3.0 (2015-10-20)

  • updated to adagucserver 1.9.3 with sqlite

0.2.1 (2015-03-31)

  • Fixed update mode.

0.1.0 (2015-03-30)

Initial Release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page