Skip to main content

Installing the Huntress Agent

Alan Bishop
  • Updated

Team: Huntress EDR
Environment: Windows, Mac
Summary: How to install the Huntress Agent

 

Installing the Huntress Agent process is easy. We're talking flip-phone-using-Grandma-can-install-it easy. Find out if you have one of the Supported Operating Systems and then follow the simple steps.

In this article

1Downloading the Huntress Agent installer (HuntressInstaller.exe)

2Running the installer (with Account Key, Organization Key, and Tags)

3Silent Install (install from command-line)

4Supported Operating Systems/System Requirements

For our partners using RMM/deployment software, we've automated these processes for you through deployment scripts:

For other solutions or customized installation processes, we've provided several convenient methods to help you as well:

Download Options

  • Click through the Huntress Web Interface
  • Fetch from a Huntress URL

NOTE: We've designed the installer to automatically detect your host's architecture (32 or 64-bit) and install the appropriate agent for you. One less thing for you to worry about ;)

Installation Options

Download the Agent Installer from the Web Interface

  1. Login to the Huntress Dashboard


  2. Hover over the Huntress options menu in the upper-right corner of the dashboard and select the "Download Agent" option from the menu
    Download.png

  3. On the Installer page, you can retrieve your Account Secret Key and the Huntress Agent installer.

    file-RCtNQxyheI.png

NOTE:  Fetching the installer from a URL is convenient for automated processes and scripts. (Replace <acct_key> with your actual Account Key and browse to the URL.)

https://huntress.io/download/<acct_key>/HuntressInstaller.exe

Manual Installation from the GUI

file-UPm5h138ge.png

  1. To manually install Huntress, simply double click on the HuntressInstaller.exe file and follow the GUI-driven prompts.
  2. Enter your Account Key.
    NOTE: The installer expects an account key that is 32 characters long. If you see "Please enter a valid Account Key" it is often because a copy/paste has introduced a space at the end or missed a character.
  3. For the Organization Key, specify a short name or phrase that uniquely identifies the client/organization this agent is associated with. Any agent installed with this same key will be grouped within the same Organization.
  4. You can optionally specify Tags to group your agents within an organization.
  5. Click the "Install" button to finish your manual installation.

Silent Installation from a Script or Command Line

Silent installation is suitable for deployments using an RMM or configuration management solution where end-users will not be interrupted with pop-ups. The installer supports the following flags:

  • /ACCT_KEY - specify the Account Key (required)
  • /ORG_KEY - specify the Organization Key (required)
  • /S - perform a silent installation (required) MUST BE UPPERCASE
  • /TAGS - specify any Tags (optional)

Example:

HuntressInstaller.exe /ACCT_KEY="acct_key" /ORG_KEY="Wibble Bank" /TAGS="Servers,Critical" /S

For directions on single-line command to install the Huntress Agent (without downloading the file), please see the guide here: Single Command Installation

 

Deploy via GPO/PowerShell Script

Huntress Labs has a GitHub repository with useful scripts. Below is a direct link to instructions on deploying the PowerShell scripts via GPO.

Deploying with PowerShell

Supported Operating Systems / System Requirements

Important: Any machine that is joined to an Active Directory Domain that is unable to communicate to a domain controller will be unable to set local policies. This includes features like Host Isolation and Managed AV policies. You can test DC connectivity with the PoSh command

Test-ComputerSecureChannel -Verbose
Please see Supported Operating Systems / System Requirements

If the Agent did not install, send Product Support the log usually found here:  %temp%\huntressinstaller.log

 
Related articles: 

Comments

0 comments

Please sign in to leave a comment.

Related articles