Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Installmation is a GUI tool, similar to exe4j, which generates installers for Mac and Windows using Java 11+ JDK jpackage tool. Linux version builds and runs but I have done very little testing.

I am writing it in Kotlin.

The tool will provide the following:

1. Ability to create installable image 
2. Ability to create complete installer
3. Ability to generate batch scripts for the relevant JPackage commands
4. Ability to list the Java 9 module dependencies for an application (Jdeps Tool Dialog)

No doubt plugins for doing this in Gradle or Maven will appear, and this is meant to complement those approaches.

Release 0.2.5

Full installers for Mac and Windows can be found at

These installers are created by Installmation itself.

What's New

  • JVM arguments (for deployed JVM) can now be added


A basic walkthrough can be found at

Running from the Command Line

You can run the latest version (rudimentary so far) with the gradle command (under Java 11 or later)

gradlew runApp

These will build installers, but testing has been limited, so feedback would be welcome, as I am sure there are use cases which I have not covered.


1. JDK 11+
2. OpenJFX 11+
3. WiX Toolkit (windows only)

You do NOT need gradle installed - the gradlew script will automatically download the correct gradle version.


  1. Download JavaFX SDK 13.0.1 or later (

  2. Download JavaFX jmods 13.0.1 or later (

  3. Install them together in the same root dir e.g. /somewhere/JavaFX/13

  4. (Windows) Download WiX toolset from and add to PATH

  5. Create with JFX version and path to root dir. Here is an OSX sample:

     JDK=/Library/Java/JavaVirtualMachines/jdk-11.0.2.jdk  # this is for unit testing and must be v11+

Just to reiterate, JFX_PATH variable path should contain both jars and jmod files:


Unit Testing

The unit tests run lots of Testfx tests, some of which tests dialogs which run JDK tools like jdeps. These tests require various binaries like JDK, JavaFX libraries as input parameters, which cannot versioned inside the repo.

So on first startup for these unit tests, the object org.installmation.TestingBootstrap checks for local configuration in, to make sure JavaFX and JDK are setup.


The tests run in headless mode by default. To run tests and show their execution with the TestFX robot use the showTests environment variable

gradlew test -DshowTests=true

Sample Configurations

The samples directory contains sample configuration files to help with troubleshooting.


Creates Cross Platform Java Application Installers via Graphical User Interface








No packages published