IntelliJ IDEA 2016.2 Help

Configuring Node.js Interpreters

On this page:

Introduction

With IntelliJ IDEA, you can use local and remote Node.js interpreters.

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 set up in a Vagrant instance.

You can access a remote interpreter in three ways:

  • Using SSH credentials to access the host where the Node.js interpreter is installed.
  • Through access to the corresponding Vagrant instance.
  • According to a Server Access Configuration. This approach is also helpful if you are going to synchronize your project sources with the Web server on the target remote host.

Configuring a local Node.js interpreter

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or IntelliJ IDEA | Preferences for OS X, and click Node.js and NPM under Languages&Frameworks.
  2. On the Node.js and NPM page that opens, click the browseButton button next to the Node Interpreter drop-down list.
  3. In the Node.js Interpreters Dialog that opens with a list of all the currently configured interpreters, click add in the toolbar. In the dialog box that opens, choose Add Local on the context menu , then choose the local installation of Node.js.

    The path to the chosen interpreter is shown in Node.js Interpreters Dialog.

Configuring a remote Node.js interpreter on a host accessible through SSH connection

Before you start:

  1. Configure access to an ssh server on the target remote host and make sure this server is running.
  2. Make sure the Node.js Remote Interpreter repository plugin is installed and enabled. The plugin is not bundled with IntelliJ IDEA, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.

To configure a Node.js interpreter using SSH credentials:

  1. On the main menu, choose Run | Edit Configurations. In the Edit Configuration dialog box, that opens, click the Add New Configuration toolbar button add.png, and choose Node.js on the context menu. In the Run/Debug Configuration: Node JS dialog that opens, click browseButton next to the Node interpreter field.
  2. In the Node.js Interpreters Dialog that opens with a list of all the currently configured interpreters, click add in the toolbar. In the dialog box that opens, choose Add Remote on the context menu .
  3. In the Configure Node.js Remote Interpreter Dialog that opens, choose the SSH Credentials method.
  4. Specify the name of the remote host and the port which the SSH server listens to. The default port number is 22.
  5. Specify your credentials to access the remote host in accordance with the credentials received during the registration on the server. Type your user name and choose the authentication method:
    • To access the host through a password, choose Password from the Auth type drop-down list and type the password.
    • To access the host through a pair of SSH keys, choose Key pair, then specify the path to the file where your private key is stored or the passphrase if you have configured it during the generation of the key pair.
  6. Specify the location of the Node.js executable file in accordance with the development environment configured on the selected remote host. By default IntelliJ IDEA suggests the /usr/bin/node folder. To specify another folder, click the Browse button browseButton and choose the relevant folder in the dialog box that opens. Note that the Node.js home directory must be open for edit.
  7. When you click OK, IntelliJ IDEA checks whether the Node.js executable is actually stored in the specified folder.
    • If no Node.js executable is found, IntelliJ IDEA displays an error message asking you whether to continue searching or save the interpreter configuration anyway.
    • If the Node.js executable is found, you return to the Node.js Interpreters where the installation folder and the detected version of the Node.js interpreter are displayed.

Configuring a remote Node.js interpreter in a Vagrant environment instance

Before you start:

  1. Make sure that Vagrant and Oracle's VirtualBox are downloaded, installed, and configured on your computer as described in Vagrant.
  2. Make sure the Vagrant and Node.js Remote Interpreter plugins are installed and enabled. The plugins are not bundled with IntelliJ IDEA, but they can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins. Once enabled, the plugins are available at the IDE level, that is, you can use it in all your IntelliJ IDEA projects.
  3. Make sure the Node.js Remote Interpreter repository plugin is installed and enabled. The plugin is not bundled with IntelliJ IDEA, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.
  4. Make sure that the parent folders of the following executable files are added to the system PATH variable:
    • vagrant.bat or vagrant from your Vagrant installation. This should be done automatically by the Vagrant installer.
    • VBoxManage.exe or VBoxManage from your Oracle's VirtualBox installation.
  5. Configure the Node.js development environment in the Vagrant instance to be used. Learn more about using Vagrant with IntelliJ IDEA in Vagrant.

To configure a Node.js Interpreter in a Vagrant instance

  1. On the main menu, choose Run | Edit Configurations. In the Edit Configuration dialog box, that opens, click the Add New Configuration toolbar button add.png, and choose Node.js on the context menu. In the Run/Debug Configuration: Node JS dialog that opens, click browseButton next to the Node interpreter field.
  2. In the Node.js Interpreters Dialog that opens with a list of all the currently configured interpreters, click add in the toolbar. In the dialog box that opens, choose Add Remote on the context menu .
  3. In the Configure Node.js Remote Interpreter Dialog that opens, choose the Vagrant method.
  4. Specify the Vagrant instance folder which points at the environment you are going to use. Technically, it is the folder where the VagrantFile configuration file for the desired environment is located. Based on this setting, IntelliJ IDEA detects the Vagrant host and shows it as a link in the Vagrant Host URL read-only field.
  5. Specify the location of the Node.js executable file in accordance with the development environment configured in the selected Vagrant instance. By default IntelliJ IDEA suggests the /usr/bin/node folder. To specify another folder, click the Browse button browseButton and choose the relevant folder in the dialog box that opens. Note that the Node.js home directory must be open for edit.
  6. When you click OK, IntelliJ IDEA checks whether the Node.js executable is actually stored in the specified folder.
    • If no Node.js executable is found, IntelliJ IDEA displays an error message asking you whether to continue searching or save the interpreter configuration anyway.
    • If the Node.js executable is found, you return to the Node.js Interpreters where the installation folder and the detected version of the Node.js interpreter are displayed.

Configuring a remote Node.js interpreter on a remote host accessible through SFTP

Before you start:

  1. Make sure a ssh server is running on the target remote host and you have configured access to it.
  2. Make sure the Node.js Remote Interpreter repository plugin is installed and enabled. The plugin is not bundled with IntelliJ IDEA, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.
  3. Make sure the Remote Hosts Access plugin is enabled. The plugin is bundled with IntelliJ IDEA and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.
  4. Make sure you have at least one IntelliJ IDEA-wide server access configuration of the type SFTP to establish access to the target host. To make a configuration available in all IntelliJ IDEA projects, clear the Visible only for this project check box in the Deployment: Connection Tab. See Creating a Remote Server Configuration for details.

To configure a remote Node.js interpreter based on an SFTP server access configuration

  1. On the main menu, choose Run | Edit Configurations. In the Edit Configuration dialog box, that opens, click the Add New Configuration toolbar button add.png, and choose Node.js on the context menu. In the Run/Debug Configuration: Node JS dialog that opens, click browseButton next to the Node interpreter field.
  2. In the Node.js Interpreters Dialog that opens with a list of all the currently configured interpreters, click add in the toolbar. In the dialog box that opens, choose Add Remote on the context menu .
  3. In the Configure Node.js Remote Interpreter Dialog that opens, choose the Deployment Configuration method.
  4. From the Deployment Configuration drop-down list, choose the server access configuration of the type SFTP according to which you want IntelliJ IDEA to connect to the target host. If the settings specified in the chosen configuration ensure successful connection, IntelliJ IDEA displays the URL address of the target host as a link in the Deployment Host URL field.

    To use an interpreter configuration, you need path mappings that set correspondence between the project folders, the folders on the server to copy project files to, and the URL addresses to access the copied data on the server . By default, IntelliJ IDEA retrieves path mappings from the chosen server access (deployment) configuration. If the configuration does not contain path mappings, IntelliJ IDEA displays the corresponding error message.

    To fix the problem, open the Deployment page under the Build, Execution, Deployment node, select the relevant server access configuration, switch to the Mappings tab, and map the local folders to the folders on the server as described in Creating a Remote Server Configuration, section Mapping Local Folders to Folders on the Server and the URL Addresses to Access Them.

  5. Specify the location of the Node.js executable file in accordance with the development environment configured on the selected remote host. By default IntelliJ IDEA suggests the /usr/bin/node folder. To specify another folder, click the Browse button browseButton and choose the relevant folder in the dialog box that opens. Note that the Node.js home directory must be open for edit.
  6. When you click OK, IntelliJ IDEA checks whether the Node.js executable is actually stored in the specified folder.
    • If no Node.js executable is found, IntelliJ IDEA displays an error message asking you whether to continue searching or save the interpreter configuration anyway.
    • If the Node.js executable is found, you return to the Node.js Interpreters where the installation folder and the detected version of the Node.js interpreter are displayed.

Configuring mappings

When you debug an application with a remote Node.js interpreter, the debugger tells IntelliJ IDEA the name of the currently processed file and the number of the line to be processed. IntelliJ IDEA opens the local copy of this file and indicates the line with the provided number. This behaviour is enabled by specifying correspondence between files and folders on the server and their local copies. This correspondence is called mapping, it is set in the debug configuration.

If you use an interpreter accessible through SFTP connection or located on a Vagrant instance, the mappings are automatically retrieved from the corresponding deployment configuration or Vagrantfile. To specify additional mappings:

  1. On the main menu, choose Run | Edit Configurations. In the Edit Configuration dialog box, that opens, click the Add New Configuration toolbar button add.png, and choose Node.js on the context menu.
  2. In the Run/Debug Configuration: Node JS dialog that opens, choose the required remote interpreter from the Node interpreter drop-down list.
  3. Click browseButton next to the Path Mappings field.
  4. The Edit Project Path Mappings Dialog that opens, shows the path mappings retrieved from the deployment configuration or Vagrantfile. These mappings are read-only.
    • To add a custom mapping, click add and specify the path in the project and the corresponding path on the remote runtime environment in the Local Path and Remote Path fields respectively. Type the paths manually or click browseButton and select the relevant files or folders in the dialog box that opens.
    • To remove a custom mapping, select it in the list and click delete.

See Also

Last modified: 23 November 2016