Using the Generic ErmineJ Distribution

Quick overview

The following are the basic steps. Operating-system specific instructions follow below.

  1. Unpack the distribution. You should have a directory called ‘ermineJ-3.0’ or something like that.
  2. Set the environment variable ERMINEJ_HOME to this directory. Confirm that the variable is set using echo $ERMINEJ_HOME (Unix); you can use env under Windows. You must also set the JAVA_HOME variable.
  3. Add $ERMINEJ_HOME/bin to your path, if you want to make it easier to execute.
  4. You can now execute ermineJ by running the script (Unix) or ermineJ.bat (Windows) in the bin directory.

You may need to do chmod a+x $ERMINEJ_HOME/bin/ to make the file executable on your system.

By default, executing the script will simply print usage instructions. To fire up the gui, use $ERMINEJ_HOME/bin/ -G .

By using the other options, you can cause ermineJ to run an analysis non-interactively.

Linux, Solaris and other *nix’s

Determine your shell by running ps .

Unpack the distribution in your home directory (~) or in ~/bin, or somewhere else you have permission and can find later.

If your shell is bash

  1. export ERMINEJ_HOME=/path/to/erminej

If your shell is csh or tcsh

  1. setenv ERMINEJ_HOME=/path/to/erminej


We recommend using the provided ErmineJ MacOSX Application package. We have not tested the Generic bundle but it should work much as it does under Unix.


We recommend using the windows installer, but you can follow steps similar to the above:

  1. Right click on the “my computer” icon on your desktop.
  2. Select “properties” from the menu.
  3. From the window that comes up, select the “advanced” tab.
  4. Click “Environment variables”
  5. Under “System variables”, click “New”.
  6. Enter ERMINEJ_HOME for the name, and the path to your download under value (Might be something like C:\Program Files\ermineJ-3.0).
  7. Click ok, and ok again, then once more.

Follow similar steps to set the JAVA_HOME environment variable, which should point to your java installation directory (e.g., C:\Program Files\Java\jre7)