Skip to content


Java is a host platform for Clojure, on which Clojure projects and tools run. No experience of Java or its platform is required for successful Clojure projects.

Install Javaλ︎

Check to see if there is an appropriate version of Java already installed.

Open a terminal and run the command

java -version

If Java is installed, you will see something like this in your terminal:

Java version check - dark version Java version check - light version

If the version is 17 or above, then jump to the Clojure install page

Install Java run time edition (JRE) using the apt package manager command in a terminal (prompts for the account login password)

sudo apt install openjdk-17-jre

Optionally include Java sources

Install the openjdk-17-source package to support navigation of Java Object and Method source code, especially useful when using Java Interoperability from within Clojure code.

sudo apt install openjdk-17-source

Practicalli Clojure CLI Config provides the :src/java17 alias to include the Java sources in the classpath when running a REPL.

If openjdk-17-jdk package is not available, add the Ubuntu OpenJDK personal package archive

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update
If you have more than one version of Java installed, set the version by opening a terminal and using the following command

sudo update-alternatives --config java
Available java versions will be listed. Enter the list number for the version you wish to use.

Using Homebrew, run the following command in a terminal to install Java 17:

brew install openjdk@17
Switching between Java versions

More than one version of Java can be installed on MacOSX. Set the Java version by opening a terminal and using one of the following commands

Show the Java versions installed

/usr/libexec/java_home -V

Switch to Java version 17

export JAVA_HOME=$(/usr/libexec/java_home -v 17)

Alternatively, install JEnv Java version manager

For Windows 10 use Windows Subsystem for Linux and Windows Terminal are recommended if you have administrative privileges and are happy to use a Unix system on the command line.

Alternatively use, a command line installer for windows. Powershell 5 or greater is required.

Follow the scoop-clojure install instructions, summarized here:

scoop bucket add java
scoop install temurin-lts-jdk

scoop can also be used to install clojure

If neither Scoop or Windows Subsystem for Linux work, try the Chocolatey package manager. Install the Java Runtime (JRE) using the following command in a command line window

choco install javaruntime

If Chocolatey does not work, then try the manual Java install.

Download OpenJDK 17 Hotspot from Adoptium - pre-build OpenJDK binaries freely available for multiple operating systems.

Run the file once downloaded and follow the install instructions.

Adoptium Prebuilt OpenJDK Binaries - web page

Multiple versions of Javaλ︎

jenv provides a simple way to switch between multiple installed versions of Java. jenv can be used to set the java version globally, for the current shell or for a specific project by adding .java-version file containing the Java version number in the root of the project.

A little Java Knowledge

Very little knowledge of the Java language or the Java Virtual Machine is required.

It is quite simple to call Java methods from Clojure, although there are a wealth of functions and libraries provided by Clojure and its community to minimise the need for Java Interoperability.

Reading stack traces may benefit from some Java experience, although its usually the first couple of lines in a stack trace that describe the issue.

Clojure uses its own build tools (Leiningen, Clojure CLI tools) and so Java build tool knowledge is not required.

When libraries are added to a project, they are downloaded to the $HOME/.m2 directory. This is the default Maven cache used by all JVM libraries.

clojure -Spom will generate a Maven pom.xml file used for deployment. Understanding of a minimal Maven POM (pom.xml) file is useful when managing issues with packaging and deployment.

Maven in 5 minutes

The Java Virtual Machine is highly optimised and does not usually require any options to enhance its performance. The most likely configuration to supply to the JVM are to manage the amount of memory assigned, specifically for resource constrained environments.

Last update: September 6, 2023