Installation on macOS Platforms #
GraalVM Community distributions for macOS are comprised to tar.gz file. Unlike Oracle JDK or OpenJDK distributions for macOS that comes with the .dmg download, GraalVM does not provide the installation wizard.
On the contrary to OpenJDK installations performed only on a
systemwide basis, GraalVM environment can be installed for a
single user, so administrator privileges are not required. However, if
GraalVM is meant to become a default JDK, administrator privileges
are required. The JDK installation path is
Follow these steps to install GraalVM Community on x86 64-bit macOS operating systems.
- Navigate to GraalVM Releases repository on GitHub. Depending on the workload, select GraalVM Community Edition based on JDK8 for macOS or GraalVM Community Edition based on JDK11 for macOS and download.
- Extract the archive to your file system:
tar -xvf <graalvm-archive>.tar.gz
Alternatively, open the file in Finder.
- Move the downloaded package to its proper location, the
/Library/Java/JavaVirtualMachinesdirectory. Since this is a system directory,
sudo mv <graalvm> /Library/Java/JavaVirtualMachines
To verify if the move is successful and to get a list of all installed JDKs, run
- There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment.
- Point the
PATHenvironment variable to the GraalVM’s
Verify whether you are using GraalVM with
- Set the
JAVA_HOMEenvironment variable to resolve to the GraalVM installation directory:
To check whether the installation was successful, enter
- Point the
Optionally, you can specify GraalVM as the JRE or JDK installation in your Java IDE.
For Oracle GraalVM Enterprise Edition users, find the installation instructions here.
Note on macOS java_home command
The information property file, Info.plist, is in the top level Contents
folder. This means that GraalVM participates in the macOS specific
/usr/libexec/java_home mechanism. Depending on other JDK installation(s)
available, it is now possible that
/usr/libexec/java_home -v1.8 returns
You can run
/usr/libexec/java_home -v1.8 -V to see the complete list of 1.8
JVMs available to the
java_home command. This command appears to sort the JVMs
in decreasing version order and chooses the top one as the default for the
specified version. Within a specific version, the sort order appears to be
stable but is unspecified.
Install Additional Components #
- Native Image – a technology to compile an application ahead-of-time into a native executable.
- LLVM toolchain – a set of tools and APIs for compiling native programs to bitcode that can be executed with on the GraalVM runtime. Language Runtimes:
- Python – Python 3.8.5 compatible
- Ruby – Ruby 2.6.6 compatible
- R – GNU R 3.6.1 compatible
- Wasm – WebAssembly (Wasm) These functionalities are not part of the GraalVM Community base distribution and must be downloaded and installed separately.
To assist a user with installation, GraalVM includes GraalVM Updater, a command line utility to install and manage additional functionalities. Proceed to the installation steps to add any necessary language runtime or utility from above to GraalVM.