WebStorm 2024.3 Help

Change the boot Java runtime of the IDE

As a Java application, WebStorm requires a Java runtime environment (JRE). By default, WebStorm uses JetBrains Runtime (a fork of OpenJDK), which is included with the IDE. JetBrains Runtime fixes various known OpenJDK and Oracle JDK bugs, and provides better performance and stability. However, in some cases you may be required to use another Java runtime or a specific version of JetBrains Runtime.

Switch the Java runtime used to run WebStorm

  1. In the main menu, go to Help | Find Action or press Ctrl+Shift+A.

  2. Find and select the Choose Boot Java Runtime for the IDE action.

  3. Select the new desired runtime and click OK.

    If necessary, you can change the location where WebStorm will download the selected runtime.

  4. Wait for WebStorm to restart with the new runtime.

When you open the Choose Boot Runtime for the IDE dialog for the first time, it may take a while to load the list of JetBrains Runtime builds from the server.

Choose Boot Runtime for the IDE

To use a different Java runtime available on your computer, select Add Custom Runtime under Advanced in the New field. WebStorm lists all the JDKs and JREs that it was able to detect. Select one or click Add JDK to specify the location of the desired Java home directory.

To reset back to the default runtime that the IDE initially used, click Use Default Runtime.

The path to the selected runtime is stored in the webstorm.jdk or webstorm64.jdk file in the WebStorm configuration directory. If there are problems with the selected runtime, you can delete this file to revert to the default runtime.

You can also override the runtime used for WebStorm by adding the WEBIDE_JDK/WEBIDE_JDK_64 environment variable with the path to the desired JDK home directory.

Last modified: 11 October 2024