GoLand
 
2022.3
Shortcuts: Windows
Get GoLand
You are viewing the documentation for an earlier version of GoLand.
  1. Supported languages
  2. Node.js
  3. Configuring remote Node.js interpreters

Configuring remote Node.js interpreters

Last modified: 12 December 2022

Required plugins:

JavaScript and TypeScript, JavaScript Debugger -  The plugins are bundled with GoLand and enabled by default.

Node.js and Node.js Remote Interpreter -  Install the plugins on the Settings/Preferences | Plugins page, tab Marketplace.

note

Local interpreters are configured on the Node.js page, see Configuring a local Node.js interpreter.

In GoLand, you need to configure a remote Node.js interpreter when you want to develop, test, lint, run and debug your application on Node.js installed on a remote host or in a virtual environment.

Remote Node.js interpreters are configured in the Configure Node.js Remote Interpreter dialog. You can open this dialog from the Node.js page of the Settings/Preferences dialog or later, when you create or edit a Node.js run/debug configuration for running or debugging your application in a remote environment.

The recommended way is to configure a remote Node.js interpreter in the Settings/Preferences dialog. In this case you can set the interpreter and the associated package manager as default for your project.

A remote Node.js interpreter that you configure right in the Node.js run/debug configuration can be used only with this run/debug configuration.

Remote Node.js interpreter on a host accessible through SSH connection

Before you start

  1. Install the Node.js and Node.js Remote Interpreter plugins on the Settings/Preferences | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains repository.

  2. Make sure the FTP/SFTP/WebDAV Connectivity plugin is enabled in the settings. Press Ctrl+Alt+S to open the IDE settings and select Plugins. Click the Installed tab. In the search field, type FTP/SFTP/WebDAV Connectivity. For more details about plugins, see Managing plugins.

  3. Configure access to an SSH server on the target remote host as described in Create SSH configurations and make sure this server is running.

Node.js interpreters via SSH are configured in the Configure Node.js Remote Interpreter dialog. You can open this dialog from the Node.js page of the Settings/Preferences dialog or later, when you create or edit a Node.js run/debug configuration for running or debugging your application.

The recommended way is to configure a remote Node.js interpreter in the Settings/Preferences dialog. In this case you can set the interpreter and the associated package manager as default for your project.

A remote Node.js interpreter that you configure right in the Node.js run/debug configuration can be used only with this run/debug configuration.

Configure a remote Node.js interpreter via SSH in the Settings/Preferences dialog

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

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

  3. In the Node.js Interpreters dialog with a list of all the currently configured interpreters, click the Add button on the toolbar and select Add Remote from the context menu .

    Configure Node.js interpreter via SSH: Add Remote

  4. In the Configure Node.js Remote Interpreter dialog that opens, select SSH.

  5. Select an SSH configuration to use.

    Configure remote Node.js interpreter via SSH: select SSH configuration

    Alternatively, click the Browse button and create a new SSH configuration as described in Create SSH configurations.

  6. Click OK to return to the Node.js Interpreters dialog where the new interpreter is added to the list.

    Remote Interpreters dialog: the new Node.js interpreter via SSH added to the list

  7. To set the newly configured interpreter as project default, select it in the list and click OK to return to the Node.js dialog.

    GoLand automatically uses this interpreter every time you select the Project alias from Node Interpreter lists, for example, when creating run/debug configurations.

    To use the package manager associated with the new interpreter for managing your project dependencies, set this package manager as default in your project. To do that, specify the location of the package manager in the Package manager field.

    The default location for npm executable is /usr/local/lib/node_modules/npm.

    Configure Node.js interpreter via SSH: set as default project interpreter

Configure a remote Node.js interpreter via SSH in a run/debug configuration

  1. From the main menu, select Run | Edit Configurations. In the Edit Configuration dialog that opens, click the Add New Configuration button on the toolbar and select Node.js from the context menu. The Run/Debug Configuration: Node.js dialog opens.

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

    Node.js run/debug configuration: JavaScript file specified

    The Node.js Interpreters dialog opens.

  3. Click the Add button on the toolbar and select Add Remote from the context menu.

    Node.js via SSH: run/debug configuration, configure interpreter, select Add Remote

  4. Configure a remote Node.js interpreter via SSH as described above.

Node.js interpreter in a Vagrant instance

With Vagrant, you can quickly bootstrap your Node.js application to run, debug, and profile it from GoLand.

Before you start

  1. Install the Node.js, Node.js Remote Interpreter, and Vagrant plugins on the Settings/Preferences | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains repository.

  2. Make sure Vagrant and Oracle's VirtualBox are downloaded, installed, and configured on your computer, see Vagrant for details.

  3. 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.

Node.js interpreters in Vagrant environments are configured in the Configure Node.js Remote Interpreter dialog. You can open this dialog from the Node.js page of the Settings/Preferences dialog or later, when you create or edit a Node.js run/debug configuration for running or debugging your application in a Vagrant environment.

The recommended way is to configure a remote Node.js interpreter in the Settings/Preferences dialog. In this case you can set the interpreter and the associated package manager as default for your project.

A remote Node.js interpreter that you configure right in the Node.js run/debug configuration can be used only with this run/debug configuration.

Configure a Node.js interpreter in the Settings/Preferences dialog

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

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

  3. In the Node.js Interpreters dialog with a list of all the currently configured interpreters, click the Add button on the toolbar and select Add Remote from the context menu .

    Configure Node.js remote interpreter: Add Remote

  4. In the Configure Node.js Remote Interpreter dialog that opens, select Vagrant.

  5. Specify the Vagrant instance folder that 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, GoLand detects the Vagrant host and shows it as a link in the Vagrant Host URL read-only field.

    By default, the field shows the current project folder.

  6. In the Node.js interpreter path field, specify the location of the Node.js executable file.

    Configure remote Node.js interpreter in Vagrant environment: specify instance folder and location of Node executable

    To locate the Node.js executable, open the embedded Terminal (Alt+F12) and type:

    vagrant ssh
whereis node
exit
    Locate Node.js executable in a Vagrant environment

  7. Click OK to return to the Node.js Interpreters dialog where the new interpreter is added to the list.

  8. To set the newly configured interpreter as project default, select it in the list and click OK to return to the Node.js dialog.

    Remote Interpreters dialog: the new Node.js interpreter in a Vagrant environment added to the list

    GoLand automatically uses this interpreter every time you select the Project alias from Node Interpreter lists, for example, when creating run/debug configurations.

  9. Specify the path to the package manager to use.

    Configure remote Node.js interpreter: package manager specified

    To locate the package manager, open the embedded Terminal (Alt+F12) and type:

    vagrant ssh
whereis <package manager>
exit
    Locate a package manager in a Vagrant environment

Configure a Node.js interpreter in the Node.js run/debug configuration

  1. From the main menu, select Run | Edit Configurations. In the Edit Configuration dialog that opens, click the Add New Configuration button on the toolbar and select Node.js from the context menu. The Run/Debug Configuration: Node.js dialog opens.

  2. Click the Browse button next to the Node interpreter field . The Node.js Interpreters dialog opens.

  3. Click the Add button on the toolbar and select Add Remote from the context menu.

    Remote Interpreters dialog

  4. Configure a remote Node.js interpreter in a Vagrant environment as described above.