Skip to content

Install the Lightrun plugin in your JetBrains IDE

To use Lightrun from your IDE, you must first install the Lightrun IDE plugin.

Support

Lightrun currently supports IntelliJ IDEA, PyCharm, WebStorm, Visual Studio Code (VSCode), VSCode for the web (vscode.dev), and code-server. Support for additional IDEs is coming soon - sign up for our beta program to learn more!

Version Support

The instructions below apply to JetBrains IDEs (IntelliJ IDEA, WebStorm, and PyCharm) v2019.3 onwards. Follow the instructions here to update your JetBrains IDE.

Lightrun supports the following installer types to cater for the different deployment environments. When you access the Management Portal, the appropriate installer type for your specific deployment is automatically displayed.

How can I detect my deployment environment?

Installing the Lightrun plugin from the JetBrains Plugin Marketplace

  1. Navigate to Preferences (Mac OS) or Settings (Windows/Linux) in your JetBrains IDE.

    JetBrains IDE Preferences

  2. Go to the Plugins section and select the Marketplace tab. Search for Lightrun and click Install: Install Plugin from Marketplace --half

  3. When prompted, restart the IDE. After the restart, Lightrun will appear in the right-hand sidebar and you can log into it by clicking the Login button. Lightrun In Your IDE --half

  4. Once logged in, you can move on to the final step - running the Lightrun Agent with your application:

    - Java agent

    - Python agent

    - Node.js agent

Installing the Lightrun plugin manually

To install the Lightrun plugin manually:

  1. Open a browser and log in to your Lightrun account.
  2. Navigate to Install the Plugin in your IDE > JetBrains IDE(IntelliJ IDEA, PyCharm, Rider, or WebStorm) > Manual Installation. Manual installation -half

  3. Click Download the plugin to download the Lightrun plugin .zip file.

    Note

    Do not unzip the downloaded file.

  4. Navigate to Preferences (Mac OS) or Settings (Windows/Linux) in your JetBrains IDE. JetBrains IDE Preferences

  5. Go to the Plugins section and click the cog icon cog icon --icon.

  6. In the menu that opens, click Install Plugin from Disk, then select the .zip file that was downloaded in the first step. Install Plugin from disk --third

  7. In the window that opens, click on Restart IDE and wait for the changes to take effect.

  8. After the IDE restarts, authenticate your plugin by clicking the Login or Register button in the plugin tool window.

Installing the Lightrun plugin from a custom plugin repository

Requirements

This installation option is only available to our single tenant and on-premise customers. For more information, please reach out to our support team.

To install the Lightrun plugin from a custom plugin repository:

  1. Open a browser and log in to your Lightrun account.
  2. Navigate to Install the Plugin in your IDE > JetBrains IDE(IntelliJ IDEA, PyCharm, Rider, or WebStorm) > Custom repository Installation.
  3. Copy the custom repository URL. Custom Repository -half

  4. Navigate to Preferences (on Mac OS) or Settings (on Windows/Linux) in your JetBrains IDE. JetBrains IDE Preferences

  5. Go to the Plugins section and click the cog icon cog icon --icon.

  6. In the menu that opens, click Manage Plugin Repositories... to open the Custom Plugin Repositories dialog. Manage plugin repositoryes --third

  7. Click + in the Custom Plugin Repositories dialog and add the copied repository URL.

  8. Click OK in the Custom Plugin Repositories dialog to save the plugin repository.
  9. Click OK in the Settings dialog to apply the change.
  10. Go back to the Plugins section and select the Marketplace tab.
  11. Search for Lightrun and click Install on the result which includes your organization's name. Custom plugin repository --half

  12. In the window that opens, click on Restart IDE and wait for the changes to take effect.

  13. After the IDE restarts, authenticate your plugin by clicking the Login or Register button in the plugin tool window.

Last update: December 5, 2023