Installation

Table of Contents

This quick tutorial will show you how to download IGMAS+ and how to install and run it on different platforms1.

Download

IGMAS+ is distributed in a form of a Java .jar installation package via the open GFZ GitLab repository IGMAS+ Releases.

You can also pick an older release if necessary.
Track the history of releases here.

Install

Before installation, please check that the correct version of Java Runtime Environment is installed (see requirements).

Install on Windows

  1. Browse to the folder that contains the downloaded installation package file IGMAS-install.jar
  2. Execute the installer by double clicking on the file
  3. The installer starts, select language and follow the instructions of the installer
If the installer doesn’t start after double-clicking check troubleshooting or use the command-line installation.
During installation step 8, mark the appropriate checkbox to create desktop shortcuts, if needed.

Installation using command line:

  1. Open Windows Command Prompt (cmd) or PowerShell

  2. Change directory to the one that contains the installation package file IGMAS-install.jar

  3. Run command:

    java -jar IGMAS-install.jar

  4. The installer starts, follow the instructions of the installer.

After installation is completed, IGMAS+ is ready for use with no need to restart the computer.

Install on Linux

First check if the right Java version is installed on your system by running the following command in the terminal:

java -version

It should return the version (1.8) of Java installed on your system, e.g.:

openjdk version "1.8.0_442"
OpenJDK Runtime Environment (build 1.8.0_442-8u442-b06~us1-0ubuntu1~22.04-b06)
OpenJDK 64-Bit Server VM (build 25.442-b06, mixed mode)

If Java is not installed, you can install it by running the following command in the terminal, e.g. on Ubuntu:

sudo apt-get install openjdk-8-jre

Then, to install IGMAS+:

  1. Browse to the location that contains the downloaded installation package file IGMAS-install.jar or download the installation package directly from the terminal, e.g., the latest release:

    wget -O IGMAS-install.jar https://git.gfz-potsdam.de/igmas/igmas-releases/-/raw/master/IGMAS-install.jar?inline=false

  2. Execute the installer by running the following command in the terminal:

    java -jar IGMAS-install.jar

  3. The installer starts, follow the instructions of the installer.
    Make sure to enable checkbox “Create additional shortcuts on the desktop” if you want to create the desktop shortcuts:

    igmas-installer-create-shortcuts

Install on macOS1

…to be added..

Run

When you run IGMAS+ for the first time you will be asked to choose a layout theme and install a license certificate.

See more information on how to setup IGMAS+

Run on Windows

On Windows start IGMAS+ with a desktop icon or with the app icon in the start menu.

Alternatively:

  1. In Windows Explorer navigate to the bin folder in the home directory where IGMAS+ has been installed, e.g. C:\Users\user\IGMAS+\bin

  2. This folder should contain the file igmas-process-wrapper.jar

  3. Open Windows Command Prompt (type cmd in the Windows Explorer path)

  4. Run the following command in the opened terminal:

    javaw -cp ./igmas-process-wrapper.jar; igmas.process.StartIGMASProcess

Run on Linux

Start IGMAS+ with a desktop icon or with the app icon in the list of applications.

Alternatively:

  1. Navigate to the bin folder in the home directory where IGMAS+ has been installed, e.g. /home/user/IGMAS+/bin:

    cd ~/IGMAS+/bin

  2. This folder should contain the file igmas-process-wrapper.jar

  3. Run the following command in the terminal:

    java -cp ./igmas-process-wrapper.jar igmas.process.StartIGMASProcess

Run on macOS1

…to be added..

Uninstall

Uninstalling IGMAS+ before installing a new version of the software is generally not required. You can just install the new version on top of the old one. The license status as well as all preferences will remain.

IGMAS+ should not be running during updating/uninstalling.

Uninstall on Windows

Find IGMAS+ Uninstaller in the list of applications and run it, or run the following command in the Windows Command Prompt (cmd):

java -jar %USERPROFILE%\IGMAS+\Uninstaller\uninstaller.jar

The uninstaller app will open:

  1. Mark the checkbox to force the deletion of IGMAS+ folder, if necessary
  2. Click Uninstall and then Quit
  3. Delete remaining folder .IGMAS+ with
rmdir /s /q %USERPROFILE%\.IGMAS+

Alternatively, just delete the folders IGMAS+ and .IGMAS+ in the home directory where it was installed, e.g.:

  • C:\Users\user\IGMAS+
  • C:\Users\user\.IGMAS+

IGMAS+ preferences remain in the Windows Registry. When re-installing IGMAS+, these preferences will be applied to the newly installed version of IGMAS+.

To delete the registry directory related to IGMAS+, run Windows Registry Editor (simply type regedit in the start menu or in the Windows Command Prompt) and delete this folder:

Computer\HKEY_CURRENT_USER\Software\JavaSoft\Prefs\igmas

Uninstall on Linux

Find IGMAS+ Uninstaller in the list of applications and run it, or run the following command in the terminal:

java -jar ~/IGMAS+/Uninstaller/uninstaller.jar

The uninstaller app will open:

igmas-uninstaller-linux

Click Uninstall and then Quit.

Use checkbox to the delete the installation folder too, if necessary.

Clean the remaining folder .IGMAS+ with:

rm -rf ~/.IGMAS+

Alternatively, delete the folders IGMAS+ and .IGMAS+ in the home directory where it was installed, e.g.:

rm -rf ~/IGMAS+ ~/.IGMAS+

Then remove shortcuts from the desktop:

rm ~/Desktop/IGMAS+*.desktop

and from the applications menu:

rm ~/.local/share/applications/IGMAS+*.desktop

Remove the registry directory related to IGMAS+ with:

rm -rf ~/.java/.userPrefs/igmas

Uninstall on macOS

…to be added…

  1. IGMAS+ supports only macOS versions older than 10.14.
    See more information in requirements. ↩︎ ↩︎ ↩︎

Last updated on Mar 4, 2025