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 onlyCommands
| Command | What 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] --global | Makes it the default for new shells and apps. |
jkit reset <tool> | Clears a shell-level choice; the global version applies again. |
jkit list | Shows 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
| Variable | Points to |
|---|---|
JAVA_HOME | The active JDK |
MAVEN_HOME | The active Maven |
GRADLE_HOME | The active Gradle |
GRAALVM_HOME | The graalvm slot, or the active JDK when it is GraalVM-based. Never put on PATH. |
PATH | The 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:
| Name | Distribution |
|---|---|
temurin (default) | Eclipse Temurin |
corretto | Amazon Corretto |
zulu | Azul Zulu |
liberica | BellSoft Liberica |
oracle | Oracle JDK |
openjdk | OpenJDK builds from jdk.java.net |
graalvm-ce | GraalVM Community |
graalvm | Oracle GraalVM |
liberica-nik | Liberica Native Image Kit |
mandrel | Mandrel |
sapmachine | SapMachine |
semeru | IBM Semeru |
microsoft | Microsoft Build of OpenJDK |
dragonwell | Alibaba Dragonwell |
kona | Tencent Kona |
jetbrains | JetBrains Runtime |
Planned
- jkit.toml and jkit.lock project files, with pin, sync and sync --frozen
- status, env, doctor, init, prune, outdated
- config get / set / list
- self update and a daily update notice
- Opt-in Gradle and Maven toolchain integration
- Signed macOS and Windows builds, Homebrew, Scoop and winget