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