Docs

New here? Start with Install. This page covers how versions and vendors are written, every command in the current prototype, and what comes next.

Tools, versions and vendors

jkit manages four tools: jdk, maven, gradle andgraalvm. Write a tool as tool@version; the version is a prefix, sojdk@21 means the newest 21 and jdk@21.0.5 narrows it further. Leave the version out for the newest release.

For jdk and graalvm, add a vendor after the spec:jkit install jdk@21 zulu. Without one, jkit uses your default vendor, Temurin unless you set jdk.vendor in ~/.jkit/config.toml orJKIT_JDK_VENDOR. jkit never quietly swaps to another vendor; if yours has no build, it tells you who does.

jkit install jdk@21              # newest 21 from the default vendor
jkit install jdk@21 zulu         # newest Zulu 21
jkit install maven@3.9
jkit install gradle@9
jkit install graalvm@25          # GraalVM-based vendors only

Commands

CommandWhat it does
jkit search <tool>[@version] [vendor]Lists available versions. For jdk: a grid of vendors against major versions, with LTS releases and installed builds marked; jdk@21 lists each vendor's newest 21 build. --maintained hides end-of-life versions; --pre adds pre-releases; --fx shows JavaFX builds.
jkit install <tool>@<version> [vendor]Resolves the newest matching version, downloads it, checks its checksum and installs it. --fx installs a JavaFX build, kept beside the plain one. Never prompts.
jkit upgrade [tool[@major]] [vendor]Installs the newest build within each installed major version (21.0.5 → 21.0.9, never 21 → 25). Older builds stay installed; --global moves along when it pointed at that line's newest build. --dry-run shows what would change.
jkit use <tool>@<version> [vendor]Activates an installed version in this shell only (needs the shell hook). Plain builds win over JavaFX builds unless you add --fx.
jkit use <tool>@<version> [vendor] --globalMakes it the default for new shells and apps.
jkit reset <tool>Clears a shell-level choice; the global version applies again.
jkit listShows what is installed, which version is global or active in this shell, and which builds bundle JavaFX. Never uses the network.
jkit remove <tool>@<version> [vendor]Removes installed versions. Refuses a global or active version unless you add --force; asks for --all when several match. --fx removes JavaFX builds.
jkit hook <shell>Prints the shell hook for bash, zsh or fish. For bash and zsh it includes tab completion.
jkit completion [bash]Prints the bash completion script: commands, options, tools and common vendors. The Linux packages install it, and the shell hook loads it, so you rarely need this directly. Works in zsh through bashcompinit.

--refresh fetches version lists again (they are cached for 24 hours);--offline uses only the cache. When use or removefinds no installed match, jkit prints the install command and exits with code 3.

Environment variables jkit sets

VariablePoints to
JAVA_HOMEThe active JDK
MAVEN_HOMEThe active Maven
GRADLE_HOMEThe active Gradle
GRAALVM_HOMEThe graalvm slot, or the active JDK when it is GraalVM-based. Never put on PATH.
PATHThe active versions' bin folders, ahead of the global ones

Installs live in ~/.jkit; set JKIT_HOME to use another folder.

Vendors

Versions come from the foojay Disco API, so any vendor it lists works under its foojay name. The usual ones:

NameDistribution
temurin (default)Eclipse Temurin
correttoAmazon Corretto
zuluAzul Zulu
libericaBellSoft Liberica
oracleOracle JDK
openjdkOpenJDK builds from jdk.java.net
graalvm-ceGraalVM Community
graalvmOracle GraalVM
liberica-nikLiberica Native Image Kit
mandrelMandrel
sapmachineSapMachine
semeruIBM Semeru
microsoftMicrosoft Build of OpenJDK
dragonwellAlibaba Dragonwell
konaTencent Kona
jetbrainsJetBrains Runtime

Planned