PyCharm 2024.1 Help

Node.js Interpreters Dialog

The following Node.js versions are supported in PyCharm 2023.3 and later:

  • Node.js 20 - the Active Long Term Supported (LTS) version

  • Node.js 21 - the current version

Learn more from Supported Node.js versions.

Use this dialog to configure a local or remote Node.js interpreter or a Node.js on Windows Subsystem for Linux.

The term local Node.js interpreter denotes a Node.js installation on your computer. The term remote Node.js interpreter denotes a Node.js installation on a remote host or in a virtual environment.

Before you start

  1. Download and install Node.js.

  2. Make sure the Node.js plugin is enabled in the settings. Press Ctrl+Alt+S to open the IDE settings and then select Plugins. Click the Installed tab. In the search field, type Node.js. For more information about plugins, refer to Managing plugins.

  3. If you are going to configure a remote interpreter, install the Node.js Remote Interpreter plugin on the Settings | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains Marketplace.

Open the Node.js Interpreters dialog

The way you get to the Node.js Interpreters dialog depends on the type of interpreter you want to use.

You need a local or a WSL Node.js interpreter

  1. Open the Settings dialog (Ctrl+Alt+S) , go to Languages & Frameworks | Node.js.

  2. Click the Browse button next to the Node Interpreter field.

Open the Node.js Interpreters dialog from Settings

You need a remote Node.js interpreter

  1. Go to Run | Edit Configurations, then select the required Node.js run/debug configuration. For more information, refer to Working with run/debug configurations.

  2. In the Run/Debug Configuration: Node.js dialog, click the Browse button next to the Node Interpreter field.

Open the Node.js Interpreters dialog from Node.js run configuration

Configure Node.js interpreters

The Node.js Interpreters dialog lists all the configured local, WSL, and remote Node.js interpreters that are available in the current context.

You can open the dialog from the Node.js page or from a Node .js run configuration.

Use the Add button, the Remove button, and the Edit button to add and remove existing Node.js configurations as well as create new ones based on their settings.

the Add button


Click this button to add a new Node.js interpreter to the list and select Add Local, Add Remote, or Add WSL from the list.

Depending on your choice, select the relevant local Node.js installation, or configure a remote interpreter in the Configure Node.js Remote Interpreter dialog, or specify the Linux distribution you’re using and the path to Node.js in the Add WSL Node Interpreter dialog.

the Remove button


Click this button to remove the selected interpreter from the list.

the Edit button


Click this button to create a new interpreter with the settings copied from the selected one.

Last modified: 11 February 2024