Installing the Huntress macOS Agent

Team: Huntress EDR
Product: macOS agent installation
Environment: macOS 11 (Big Sur) and newer
Summary: The macOS agent installation can be performed via the GUI (HuntressAgent.pkg), script (from terminal) or deployed via an RMM/MDM/Terminal.

We highly recommend reading this KB on Full Disk Access before getting started as TCC can be a mysterious road block (especially if you are getting generic "The Installationfailed" error messages). The Huntress macOS Agent is supported on macOS 11 Big Sur and above. See here for more information.  

In this article

1Running the Huntress macOS GUI installer (HuntressAgent.pkg)

2Running the Huntress macOS Script Installer (install script from Terminal)

3Deployment through RMM/MDM/Terminal (auto-download the latest version)

Running the Huntress macOS GUI installer

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
   
   
   
3. On the Download Agent page, scroll down to the macOS Installer section and download the .pkg installer.

   

4. Scroll back up to copy your Account Key to your clipboard.

    

5. Run the GUI pkg installer in order to manually install the Huntress macOS agent by double clicking on the downloaded pkg. Click through prompts until you reach the Account panel. 

    

6. Enter your Account key copied from step 4. NOTE: The installer expects an account key that is 32 characters long. 
7. 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.
8. You can optionally specify Tags to group your agents within an organization.
9. Continue through the following prompts to finish your manual installation.
10. Once installed, make sure you grant Full Disk Access to Huntress.  
    1. Open up System Preferences and click on “Security & Privacy” 
    2. On the bottom left, click on “Click the lock to make changes.” Enter in your Mac password.
    3. Go into Privacy. On the left select “Full Disk Access”
    4. Look for Huntress on the right hand side and select the checkbox next it.  
       

Running the Huntress macOS Script Installer 

1. Go to the top right hamburger menu of the Huntress Portal and click on “Download Agent”
2. On the Download Agent page, scroll down to the macOS Script section and download the macOS install script.
3. To run the install script manually, open Terminal and type or paste in the following:

   sudo bash ~/Downloads/HuntressMacInstall.sh

4. Then follow the prompts for your Account Key and for your Organization Key. Your Account key should be found on the Download Agent page. Your Organization key will be found if you go to Organizations in the top menu and select the key for the relevant organization (this key is made up by you). 

Deployment through RMM/MDM/Terminal 

Silent installation is suitable for deployments using an RMM or configuration management solution. For our partners using RMM/deployment software, we've provided the following deployment scripts also available on our Github here:

• Addigy
• Atera
• Connectwise Automate
• Datto RMM
• Kaseya VSA
• N-Able N-Central
• NinjaRMM
• Syncro
• Generic Script w/ error checking
• Simplified Generic Script w/o error checking (use if the above doesn't work)