Risk in a Box - main project
Pull request Compare This branch is 794 commits behind AIFDR:master.
Failed to load latest commit information.



This is the project: "Risiko - Risk in a Box". It consists of the following modules:

For more information about Risk In a Box please look at our documentation on http://riab.readthedocs.org


These are the instructions for installation of Risiko in development mode (for changing the software) and production mode (for deploying on a server).

System Requirements

  • A standard PC with at least 4GB of RAM.
  • The operating system is a recent version of Ubuntu Linux. Risiko has been tested on versions 10.04 and 10.10 (32 and 64 bit).
  • The platform is using the default /etc/sources.list as it comes in a fresh Ubuntu installation. You may want to change this to a local mirror if the internet connection is slow (see e.g. https://help.ubuntu.com/community/Repositories/CommandLine) for details.
  • The user installing and running Risiko has administrator rights (using the sudo)

Development installation

This is for those who either want to try out the software and/or modify it. For installing Risiko as a public web server please see instructions for production installation.

To install a RISIKO development environment, start a terminal window, cd to your favorite development area and run the following:

wget https://github.com/AIFDR/riab/raw/master/scripts/risiko-install --no-check-certificate
bash risiko-install

This will create a working development installation and provide guidance on how to run the test suite, setup the server and try it.

Note: If you wish to commit changes back to the repository, you must

  1. Get an account on github.com
  2. Get commit access to https://github.com/AIFDR/riab
  3. Setup and register your ssh keys with your account: https://github.com/account/ssh

Production installation

This is for installing Risiko as a public web server.

It is assumed that a development system is already running (installed as per instructions above) and that the production system is a separate server that can be accessed via ssh (ssh username@remote.server).

To deploy RISIKO in production mode from your development system to the remote server run the following:

cd $RIAB_HOME/riab/extras
fab risiko -H username@remote.server

If something goes wrong, you can check the logs with the command:

fab log -H username@remote.server

You can update an existing production system to the latest revision with the command:

fab pull -H username@remote.server

The production deployment procedure is scripted in the file fabfile.py and the fabric framework is documented at http://docs.fabfile.org


Risiko is a very new project. The current code development started in earnest in March 2011 and there is still much to be done. However, we work on the philosophy that stakeholders should have access to the development and source code from the very beginning and invite comments, suggestions and contributions.

As such, Risiko currently has some major limitations, including

  • Risiko does not yet run with data loaded locally. Rather it points to a GeoServer with demo data at www.aifdr.org:8080/geoserver
  • Hazard layers must be provided as raster data
  • Exposure data must be either raster data or point vector data
  • All data must be provided in WGS84 geographic coordinates
  • Neither AIFDR nor GFDRR take any responsibility for the correctness of outputs from Risiko or decisions derived as a consequence