CheatPress

SDKMAN! JVM SDK manager

Version 5.23.2 · source

SDKMAN!, Postcard, light preview Light · Postcard 102 × 152 mm · PDF SDKMAN!, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF SDKMAN!, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
SDKMAN!, A5, light preview Light · A5 148 × 210 mm · PDF SDKMAN!, A5, dark preview Dark · A5 148 × 210 mm · PDF SDKMAN!, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
SDKMAN!, A4, light preview Light · A4 210 × 297 mm · PDF SDKMAN!, A4, dark preview Dark · A4 210 × 297 mm · PDF SDKMAN!, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
SDKMAN!, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF SDKMAN!, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF SDKMAN!, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
SDKMAN!, A3, light preview Light · A3 297 × 420 mm · PDF SDKMAN!, A3, dark preview Dark · A3 297 × 420 mm · PDF SDKMAN!, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
SDKMAN!, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF SDKMAN!, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF SDKMAN!, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
SDKMAN!, Letter, light preview Light · Letter 8.5 × 11 in · PDF SDKMAN!, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF SDKMAN!, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
SDKMAN!, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF SDKMAN!, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF SDKMAN!, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

sdk list java
Available JDKs
sdk install java <id>
Install a JDK
sdk use java <id>
This shell only
sdk default java <id>
All new shells
sdk current
Versions in use
sdk env init
Pin in .sdkmanrc
sdk env install
Set up a project
sdk upgrade
Find outdated SDKs

Concepts

source ~/.sdkman/bin/sdkman-init.sh
Load sdk into the current shell
  1. Candidate java, maven, ...
  2. Installed version candidates/<c>/<v>
  3. current link new shells
  4. This shell PATH and *_HOME

Find and install

sdk list
Browse all candidates
Opens in a pager; press q to quit.
sdk list <sdk>
List versions of one candidate
sdk install <sdk>
Install the default version
Asks whether to make it the default.
sdk install <sdk> <version>
Install a specific version
sdk install <sdk> <version> <path>
Register an existing local install
Version name must be new, e.g. 11-local.
sdk uninstall <sdk> <version>
Remove an installed version
For a local version only the link goes.
sdk update
Refresh the candidate list
Markers in sdk list <sdk>
Mark Meaning
+ Local version
* Installed
> In use

Switch versions

sdk use <sdk> <version>
Use a version in this shell
Fails if not installed; install it first.
sdk default <sdk> <version>
Set default for new shells
sdk default <sdk>
Reset to the SDKMAN default version
sdk current
Show versions in use
sdk current <sdk>
Show the version of one candidate
sdk home <sdk> <version>
Print the install path
No trailing newline: meant for $(...) in scripts.
sdk upgrade
List outdated candidates
sdk upgrade <sdk>
Upgrade one candidate

Java vendors

sdk list java
Vendor table with identifiers
Install by the Identifier column, not Version.
sdk install java <version>-tem
Install an Eclipse Temurin JDK
Identifier suffixes
Suffix Distribution
-tem Eclipse Temurin
-amzn Amazon Corretto
-zulu Azul Zulu
-librca BellSoft Liberica
-graalce GraalVM CE
-graal Oracle GraalVM
-oracle Oracle JDK
-ms Microsoft OpenJDK

Project env (.sdkmanrc)

sdk env init
Create .sdkmanrc with current java
sdk env
Switch to versions in .sdkmanrc
sdk env install
Install missing versions and switch
sdk env clear
Return to default versions
.sdkmanrc
# candidate=version, one per linejava=21.0.4-temmaven=3.9.9gradle=8.10

Maintenance

sdk version
Print script and native versions
sdk help [<subcommand>]
Show help, or help for one command
sdk selfupdate
Update SDKMAN! itself
sdk selfupdate force
Reinstall SDKMAN! even if current
sdk flush
Clear caches and leftover downloads
Use it instead of deleting ~/.sdkman/tmp by hand.
sdk flush tmp|metadata|version
Flush a single cache target
Short aliases
Alias Command
i / rm install / uninstall
ls / l list
u / d use / default
c / ug current / upgrade
h / e / v home / env / version

Configuration

sdk config
Edit ~/.sdkman/etc/config
Uses $EDITOR, else vi. Open a new shell afterwards.
Everyday keys (sdkman_ prefix)
Key Effect
auto_answer No prompts (CI)
auto_env Apply .sdkmanrc on cd
selfupdate_feature Prompt for updates
auto_complete Shell completion
colour_enable Coloured output
Network and debug keys
Key Effect
healthcheck_enable API check at startup
curl_connect_timeout Connect timeout (s)
curl_max_time Max transfer time (s)
checksum_enable Verify downloads
beta_channel Beta releases
debug_mode Verbose output
insecure_ssl Skip TLS checks (avoid)

Recipes

Set up a new machine
curl -s "https://get.sdkman.io" | bashsource "$HOME/.sdkman/bin/sdkman-init.sh"sdk install java 21.0.4-temsdk install mavensdk install gradle
Pin a project
sdk use java 21.0.4-temsdk env initecho 'maven=3.9.9' >> .sdkmanrcgit add .sdkmanrc
Non-interactive CI
sed -i 's/auto_answer=false/auto_answer=true/' \  ~/.sdkman/etc/configsdk env installexport JAVA_HOME="$(sdk home java 21.0.4-tem)"
Tidy up old versions
sdk upgradels ~/.sdkman/candidates/javasdk uninstall java 17.0.12-temsdk flush