Installation
Install integrations on your Polarity server
Last updated
Install integrations on your Polarity server
Last updated
The Polarity Integration Framework provides a way to connect data sources to Polarity so that real-time notifications can be pushed to Polarity users based on data that is important to you.
In addition to connecting to existing datasources, the integration framework allows you customize how that data is displayed in the notification window.
All Polarity Integrations are installed in a similar manner. You can install integrations by either downloading a tar archive from the GitHub releases page of the integration you are interested in, or by using to clone the repo to your server.
In the instructions below we have provided example commands which will need to be modified depending on which integration you are installing. The following variables will need to be modified when you run the example commands:
{{integration_version}} : The version of the integration you are trying to install (e.g., “1.0.1-beta”, “0.0.1”, “2.0.0”, etc.)
{{integration_name}}: The name of the integration you are trying to install. For example, “virustotal”, “google-maps”, “crits”, etc. Note that the name of the integration will match the name of the repository in GitHub.
Installing via git requires that your Polarity server has access to Github () as well as the NPM registry (). If you do not have outbound access to those domains you can install integration by .
Navigate to the integrations folder on your Polarity Server:
Generally, you will want to clone the latest release of the integration using the following command:
For example, to clone the latest VirusTotal integration you would use the following command:
If you are looking to install a specific version you can do that as well:
As an example, if you wanted to install version 3.5.1-beta of the virustotal integration you would use the commands:
Once the repo has been cloned onto your server, change into the integration directory:
Use npm to install the integration’s dependencies run the npm install command from inside the integration's directory.
Ensure the integration directory is owned by the polarityd user
Be careful when applying ownership to ensure you are targeting the integration directory specifically.
Restart the Polarity Server process.
The integration is now installed and you can use the Integrations page in Polarity-Web to configure integration specific options. Please see the README.md file of the installed integration for details about integration specific options.
Download the tar.gz file for the version of the integration you want to install (we typically recommend installing the latest version of the integration). Once downloaded, upload the tar.gz file to the Polarity Server’s integrations directory (/app/polarity-server/integrations).
If you have wget or curl installed on your Polarity Server you can download the release directly onto your server. Right click on the release link and copy the download link to your clipboard. Save a copy of this link as you will need it to download the release onto your server.
With the link from above, you can download the link using either curl or wget.
This will place the download into the /app/polarity-server/integrations directory on your server.
Once you have downloaded/uploaded the integration to your Polarity Server you will need to untar it. First, ensure you are in the integrations directory:
Then, extract the tar file:
Ensure the integration directory is owned by the polarityd user
Restart the Polarity service so the new integration can be loaded.
The integration is now installed and you can use the Integrations page in Polarity-Web to configure integration specific options. Please see the README.md file of the installed integration for details about integration specific options.
Navigate to the releases page for the integration you are installing. The URL should look like https://github.com/polarityio/${integration_name}/releases. For example, the releases page for the Virustotal integration is . You can find a link to the releases page on the right hand side of the integration’s GitHub repository.
