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, Node.js runtime with JavaScript engine, the developer tools (e.g., Chrome inspector based debugger, Profiler, etc.). Currently, the GraalVM Enterprise runtime on Windows can be extended with GraalVM Native Image.

Prerequisites for Using Native Image on Windows

To make use of Native Image on Windows, follow the following 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.