Installation on Windows Platforms

Follow these steps to install GraalVM Community Edition on x86 64-bit Windows. For Oracle GraalVM Enterprise Edition users, find the installation instructions here.

  1. Navigate to the GraalVM Releases repository on GitHub. Depending on the workload, select graalvm-ce-java8-windows-amd64-20.1.0.zip or graalvm-ce-java11-windows-amd64-20.1.0.zip and download. We will focus on GraalVM Community based on OpenJDK 8.
  2. Unzip the archive to your file system.
  3. Configure JAVA_HOME and PATH environment variables. Setting environment variables via the command line will work the same way for Windows 7, 8 and 10.
    • Add the GraalVM bin folder to the PATH environment variable:
      setx /M PATH "C:\Progra~1\Java\graalvm-ce-java8-20.1.0\bin;%PATH%"
      
    • Set the JAVA_HOME environment variable to resolve to the GraalVM installation directory:
      setx /M JAVA_HOME "C:\Progra~1\Java\graalvm-ce-java8-20.1.0"
      

      Note that the /M flag, equivalent to -m, requires elevated user privileges.

  4. Restart Command Prompt to reload the environment variables. Then use the following command to check whether the variables were set correctly:
    echo %PATH%
    echo %JAVA_HOME%
    

    Optionally you can specify GraalVM as the JRE or JDK installation in your Java IDE.

Install Additional Components

The GraalVM distribution for Windows platforms includes the JDK with the GraalVM compiler enabled, the functional GraalVM Updater utility to install additional components, GraalVM’s JavaScript engine and the developer tools (e.g., Chrome inspector based debugger, Profiler, etc.). Node.js support on the Windows platform is scheduled to be included in the next GraalVM release (20.1). GraalVM environment can be extended with additional components.

To add support for Python, R, Ruby or WebAssembly languages interpreters in GraalVM Community Edition, use a functional gu utility. There is a component catalog on GitHub maintained by Oracle (gu available), from which you can install a component just by its name:

gu install ruby
gu install r
gu install python
gu install wasm

To install the LLVM toolchain component, run:

gu install llvm-toolchain

To install GraalVM Native Image, run:

gu install native-image

Additional components may be also installed from the local components collection. For more details, proceed to the GraaVM Updater page.

Prerequisites for Using Native Image on Windows

To make use of Native Image on Windows, follow the further recommendations. The required Microsoft Visual C++ (MSVC) version depends on the JDK version that GraalVM is based on. For GraalVM distribution based on JDK 8, you will need MSVC 2010 SP1 version. The recommended installation method is using Microsoft Windows SDK 7.1:

  1. Download the SDK file GRMSDKX_EN_DVD.iso for from Microsoft.
  2. Mount the image by opening F:\Setup\SDKSetup.exe directly.

For GraalVM distribution based on JDK 11, you will need MSVC 2017 15.5.5 or later version.

The last prerequisite, common for both GraalVM distribution based on JDK 11 and JDK 8, is the proper Developer Command Prompt for your version of Visual Studio. Namely, it is should be the x64 Native Tools Command Prompt. Use Visual Studio 2017 or later.