1. Installation

This section describes how to install and run MONGKIE. Installation instructions are provided for Linux , Mac OS X, and Windows.


If you have an older version on your computer, you should uninstall it and remove the User Directories.

1.1. System Requirements

1.1.2. Java

MONGKIE is written in Java, and runs on the Java Runtime Environment. Therefore, the Java runtime (7 or 8) is required to install and run it. You can download the latest version of Java runtime from here for Windows and Linux, and OS X Lion (10.7), Mountain Lion (10.8), or Mavericks (10.9).

The tested Java versions are Java 8 and 7u67 for Windows, Linux, and OS X.


MONGKIE cannot be installed or run using Java 6.0, and OpenJDK is not supported, be sure to run the official Java version from Oracle’s website.

1.2. ZIP Distributions

  1. Download the latest release of a ZIP distribution for your OS.

  2. Unzip it to any directory on your system.

  3. Run the executable file located in the bin directory

    • On Linux, mongkie/bin/mongkie
    • On Windows, mongkie\bin\mongkie.exe
    • On OS X, mongkie.app/Contents/MacOS/mongkie

1.3. Installable Packages

Download the latest release of an installer for your OS.

1.3.1. Linux and Windows

  1. After the download completes, run the installer.

    • For Windows, the installer file has the .exe extension. Double-click the file to run it.
    • For Linux, the installer file has the .sh extension. You need to make the installer executable by using the following command: chmod +x <installer-file>. Type ./<installer-file> to start the installation wizard.
  2. Follow steps in the installation wizard.

1.3.2. OS X

  1. After the download completes, click on the downloaded .dmg file.
  2. Drag the mongkie application in your Application folder.

1.4. User Directories

userdir is the directory where MONGKIE stores user configuration data such as window layouts, and various application options. Sometimes your userdir can be corrupted and this results in the MONGKIE behaving weirdly.

To fix such issues, delete userdir entirely, then restart MONGKIE, and allow it to generate a new userdir from scratch. In most cases, this should repair the problems.

userdir is located in:

  • On Windows 2K/XP, C:\Documents and Settings\<username>\Application Data\.mongkie
  • On Windows Vista or later, C:\Users<username>\AppData\Roaming\.mongkie
  • On OS X, /Users/<username>/Library/Application Support/mongkie
  • On Linux, /home/<username>/.mongkie