Skip to main content
Version: 2026.04

Agent Installation

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

Installers​

These instructions assume that you have the agent installers on the host (or reachable to copy there).

  • istari-agent_X.Y.Z_windows-amd64.msi
  • (Beta) istari-agent_X.Y.Z_win_service-arm64.msi
  • istari-agent_X.Y.Z_amd64.rpm
  • istari-agent_X.Y.Z_amd64.deb
  • istari-agent_X.Y.Z_macos-arm64.pkg

Obtain the installers​

Download the installers for your platform and version from the Istari Customer Portal (see Download Istari software from the Customer Portal). Choose the agent assets under dist, open Asset details, then Download.

If you cannot download files, contact Istari Digital to confirm portal access and that a JFrog service account exists for your organization.

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

(Beta 11.4.0) The beta agent will be installed to %ProgramFiles%\IstariDigital\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/.

Install the Agent (macOS)​

Double-click the istari-agent_X.Y.Z_macos-arm64.pkg to run the installer and follow the installation prompts.

Alternatively, the installer can be run from the command line:

sudo installer -pkg /PATH/TO/istari-agent_X.Y.Z_macos-arm64.pkg -target /

The agent will be installed to /Applications/istari_agent. The user data will be in ~/Library/Application Support/istari_agent