1. Install InaSAFE Plugin from QGIS Repository

Note

InaSAFE is a plugin for QGIS, so QGIS must be installed first via
QGIS Python Plugin Repository.

To install InaSAFE, use the plugin manager in QGIS:

1. Click the menu Plugins ‣ plugin_installer Manage and install plugins....

2. Search for ‘InaSAFE’, select it and click the install button. The plugin will now be added to your plugins menu.

1.1. From InaSAFE test repository

During development of an InaSAFE version, developers make a test version of the software for people to trial. Here are the instructions on how to install this test version.

  1. Plugins ‣ Manage and install plugins...

  2. Click on Settings tab and Check Show also experimental plugins

    _images/installer_options.png
  3. Click on Settings tab and Add a new repository

    _images/python_installer.png
  4. Type the following into the Repository details

    Name: InaSAFE Test URL: http://experimental.inasafe.org/

    _images/repository_details.png
  5. OK

  6. You should now have 2 repositories connected, Click on Plugins

    _images/connected.png
  7. Upgrade all

    _images/upgradeable.png

1.2. From Zip Archive

Warning

This installation method is not recommended unless you have no internet access or wish to use a specific version of InaSAFE. Please rather install using the plugin repository described above.

We make regular releases of the InaSAFE plugin and they are available at http://plugins.qgis.org/plugins/inasafe/. Simply choose the most recent (i.e. the one with the largest version number) and save it to your hard disk.

Now extract the zip file into the QGIS plugins directory.

Warning

Depending on your version of QGIS the plugin directory is either under a subdirectory of .qgis (QGIS versions < 2.0) or .qgis2 (QGIS version >= 2.0).

That also means depending on your Operating System (Windows, Linux, OSX) in combination with the version of QGIS, the directory containing the plugins will be in:

  • Windows: C:\Users\<your username>\.qgis(2)\python\plugins\.
  • Linux: ~/.qgis(2)/python/plugins/ (where “~” means /home/<your username>/
  • OSX: TODO

Note

.qgis(2) means that the directory is either called .qgis or .qgis2.

Example: In Windows Operating System using QGIS 2.0 you would do following:

Locate the directory C:\Users\<your username>\.qgis2\python\plugins.

After extracting the plugin, it should be available as:

C:\Users\<your username>\.qgis2\python\plugins\inasafe\.

Mac and Linux users need to follow the same procedure but instead the plugin directory will be under the $HOME directory:

~/.qgis2/python/plugins/

Once the plugin is extracted, start QGIS and enable it from the plugin manager. To do this open the plugin manager Plugins ‣ Manage and install plugins... and type insafe into the search box. You should see the InaSAFE plugin appear in the list. Now tick the checkbox next to it to enable the plugin.

1.3. Downgrade the InaSAFE plugin to a selected version

In case you have to use an older Version of QGIS or just want to install a specific version of the InaSAFE plugin into QGIS you have to do the following steps:

  1. Fetch the plugin manually from http://plugins.qgis.org/plugins/inasafe/ by clicking on your preferred version number then clicking download.
  2. Remove your local copy from ~/.qgis2/python/plugins/inasafe That would mean delete the folder inasafe which is inside your ~/.qgis2/python/plugins directory. For Windows user this inasafe directory would be in C:\Users\<your username>\.qgis2\python\plugins
  3. Extract the downloaded version into that folder (Means to create the inasafe folder inside ~/.qgis2/python/plugins again
  4. Restart QGIS

1.3.1. Enable InaSAFE Plugin in QGIS

1. Now you will need to add the InaSAFE panel on your QGIS interface. For that, select Toggle InaSAFE Dock in the InaSAFE plugin scroll list.

_images/inasafe_plugin_toggle.png

The InaSAFE dock panel will then appear on the right of your QGIS window.

_images/inasafe_plugin_dialog.png

It is the main way to interact with the tools that are provided in InaSAFE.

Also, an InaSAFE icon will appear on the QGIS toolbar.

_images/inasafe_plugin_toolbar.png

Note

InaSAFE may not install properly depending on your operating system. You may need to install additional Python modules in order to proceed.