Install the Lightrun plugin in the JetBrains IDE🔗
To debug using Lightrun from your IDE, you first need to install the Lightrun plugin in the IDE.
Supported IDEs and versions🔗
Lightrun currently supports IntelliJ IDEA, PyCharm, WebStorm, Visual Studio Code (VS Code), VS Code for the web (vscode.dev), Visual Studio, and code-server.
For JetBrains IDEs, version 2022.3.0 and later is supported. Contact us to schedule a Demo and learn more.
Choose your plugin installation method🔗
Lightrun supports the following installer types based on your deployment environment. When you access the Management Portal, the appropriate installer type for your specific deployment is displayed.
| Deployment environment | Installation method | 
|---|---|
| SaaS users | JetBrains plugin marketplace | 
| On-premise and Single-tenant users | Manual Installation | 
| On-premise and Single-tenant users | Custom plugin repository | 
Identify your deployment environment🔗
| Deployment environment | How to identify | Recommended installation method | 
|---|---|---|
| SaaS | URL starts with https://app.lightrun.com |  JetBrains Plugin Marketplace | 
| On-premise / Single-tenant (with plugin repository) | URL is different and server provides a custom plugin repository. | Custom plugin repository | 
| On-premise / Single-tenant (no plugin repository) | URL is different and no custom plugin repository is available. | Manual installation | 
Installation instructions🔗
[SaaS only] Install plugin from the JetBrains Plugin Marketplace🔗
- Open your JetBrains IDE and go to Preferences (macOS) or Settings (Windows/Linux).
 -  
Navigate to the Plugins section and select the Marketplace tab.

 -  
Search for Lightrun and click Install.

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

 -  
Once logged in, proceed to run the Lightrun Agent with your application:
 
[On-premise and Single-tenant] Install plugin manually🔗
- Open a browser and log in to your Lightrun account.
 -  
Navigate to Install the Plugin in your IDE > JetBrains IDE (IntelliJ IDEA, PyCharm, Rider, or WebStorm) > Manual Installation.

 -  
Click Download the plugin to download the Lightrun plugin
.zipfile. Do not unzip the file before installing it. -  
Open your JetBrains IDE and go to Preferences (Mac OS) or Settings (Windows/Linux).

 -  
Go to the Plugins section and click the cog icon
. -  
Select Install Plugin from Disk, then choose the downloaded
.zipfile.
 -  
Click Restart IDE when prompted to apply changes.
 - After the IDE restarts, authenticate the plugin by clicking the Login or Register in the plugin tool window.
 
[On-premise and Single-tenant] Install plugin from a custom plugin repository🔗
- Log in to your Lightrun account in a browser.
 - Navigate to Install the Plugin in your IDE > JetBrains IDE(IntelliJ IDEA, PyCharm, Rider, or WebStorm) > Custom repository installation.
 -  
Copy the custom plugin repository URL provided.

 -  
In your JetBrains IDE, navigate to Preferences (on Mac OS) or Settings (on Windows/Linux).

 -  
Go to the Plugins section and click the cog icon
. -  
Select Manage Plugin Repositories... to open the Custom Plugin Repositories dialog.

 -  
Click + and paste the copied repository URL.
 - Click OK in the Custom Plugin Repositories dialog to save the plugin repository.
 - Click OK to save the changes.
 - Return to the Marketplace tab in the Plugins section.
 -  
Search for Lightrun and click Install on the entry that includes your organization's name.

 -  
Click Restart IDE when prompted.
 - After restart, authenticate the plugin by clicking the Login or Register in the plugin tool window.
 
Next steps🔗
After installing, authenticate the Lightrun plugin to start using it.