Skip to main content
Version: 2025.09

Agent Installation

Follow the appropriate instructions below depending on the OS of the host machine.

Installers​

These instructions assume that you have access to the agent installers.

  • istari-agent_X.Y.Z_windows-amd64.msi
  • istari-agent_X.Y.Z_amd64.rpm
  • istari-agent_X.Y.Z_amd64.deb

The agent installers can be downloaded from Artifactory.

The installers for version X.Y.Z of the agent are available directly at https://istaridigital.jfrog.io/ui/native/release-istari-agents-local/istari_agent/X.Y.Z/.

Reach out to Istari Digital if you do not have access to the agent installers in Artifactory.

Download Commands​

Windows​

Set the following environment variables:

  • Set $artifactory_username to your Artifactory username
  • Set $artifactory_token to your Artifactory login token
  • Set $agent_version to the version of the agent to download (eg 7.4.4)
  • Set $agent_installer to the filename for the agent installer you want to download (eg istari-agent_7.4.4_windows-amd64.msi)
$artifactory_username = "you@example.com"
$artifactory_token = "abcedfghijklmnopqrstuvwxyz0123456789"
$agent_version = "7.4.4"
$agent_installer = "istari-agent_7.4.4_windows-amd64.msi"

Then run the following commands:

$authentication = [Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($artifactory_username+":"+$artifactory_token))
$headers = @{ Authorization = "Basic $authentication"}
Invoke-WebRequest -Uri "https://istaridigital.jfrog.io/artifactory/release-istari-agents-local/istari_agent/$agent_version/$agent_installer" -Headers $headers -OutFile $agent_installer -MaximumRedirection 5

RHEL / Ubuntu​

Set the following environment variables:

  • Set ARTIFACTORY_USERNAME to your Artifactory username
  • Set ARTIFACTORY_TOKEN to your Artifactory login token
  • Set AGENT_VERSION to the version of the agent to download (eg 7.4.4)
  • Set AGENT_INSTALLER to the filename for the agent installer you want to download (eg istari-agent_7.4.4_amd64.rpm)

For example:

ARTIFACTORY_USERNAME="you@example.com"
ARTIFACTORY_TOKEN="abcedfghijklmnopqrstuvwxyz0123456789"
AGENT_VERSION="7.4.4"
AGENT_INSTALLER="istari-agent_7.4.4_amd64.rpm"

Then run the following command:

curl -u$ARTIFACTORY_USERNAME:$ARTIFACTORY_TOKEN -L -O "https://istaridigital.jfrog.io/artifactory/release-istari-agents-local/istari_agent/$AGENT_VERSION/$AGENT_INSTALLER"

Windows​

Copy the installer istari-agent_X.Y.Z_windows-amd64.msi onto the host machine.

Install the Agent (Windows)​

Double-click the istari-agent_X.Y.Z_windows-amd64.msi to run the installer and accept the default options in each screen.

Alternatively, the installer can be run headlessly from PowerShell with msiexec /i \PATH\TO\istari-agent_X.Y.Z_windows-amd64.msi /qn.

The agent and the agent configuration tool will be installed to %LOCALAPPDATA%\istari_agent\.

RHEL​

Copy the installer istari-agent_X.Y.Z_amd64.rpm onto the host machine.

Install the Agent (RHEL)​

Install the agent by running sudo rpm -i /PATH/TO/istari-agent_X.Y.Z_amd64.rpm

The agent will be installed to /opt/local/istari_agent/.

Ubuntu​

Copy the installer istari-agent_X.Y.Z_amd64.deb onto the host machine.

Install prerequisites​

Install the prerequisites for the agent by running sudo apt-get update && sudo apt-get install -y libmpv1

Install the Agent (Ubuntu)​

Install the agent by running sudo dpkg -i /PATH/TO/istari-agent_X.Y.Z_amd64.deb

The agent will be installed to /opt/local/istari_agent/.