Install the plugin¶
With Lightrun, you can add actions (logs, metrics, snapshots) from the source code of your live app either from your IDE, or from the CLI. To use Lightrun, [attach the Lightrun agent] to your running application and then install the plugin in your IDE.
Lightrun currently supports the IntelliJ IDE.
To install the plugin
Log in to your Lightrun account from your browser.
The Lightrun app loads.
Navigate to Getting Started=>Install the Plugin.
Scroll down to the Install the Plugin section.
Click Download plugin and store the file in a memorable location. Don't unzip the file.
Now, navigate to your IntelliJ instance.
From IntelliJ, navigate to Preferences (on Mac OS) or Settings (On Windows/Linux):
Go to the Plugins section:
Click the settings cog from the top right and select Install Plugin from Disk:
Select the plugin zip file from the folder where you stored it in step 3.
Once installed, Lightrun options appear in the Settings menu.
You can configure these settings as follows:
* Lightrun Server URL - this is our backend server it should point to the right URL by default
* Source Version Warnings - we alert you if the code in the IDE doesn't match the code that is running our agent
* Use Embedded Browser - this enables login and authentication directly from the IDE; if disabled, when logging in you are redirected to your default browser
The Use an embedded browser option uses such a browser for logging-in to the Lightrun server. If you are using the external browser but authentication fails, activate this option explicitly and update your IDE to 2020.2 or newer.
* Certificate Pinning - verifies the server certificate matches your requests and that you are actually connecting to the Lightrun server; this feature enforces security and is highly recommended
When prompted, restart IntelliJ.
Lightrun appears in the right-hand sidebar.