Skip to main content
All CollectionsVulnerability ManagementSecurityHive Agent
Installing the SecurityHive Agent
Installing the SecurityHive Agent

This guide walks you through the process of installing the SecurityHive Agent on your system. The SecurityHive Agent helps you monitor vulnerabilities and maintain robust security within your environment.

Updated over a week ago

Overview

  • Location in SecurityHive: From the main Dashboard, go to Vulnerability Management and then Agents.

  • Download Options: Choose the appropriate installer for your operating system:

    • Windows (.msi)

    • macOS coming soon

    • Linux (deb) coming soon

    • Linux (rpm) coming soon

  • Enrollment Secret: You will be prompted to enter your enrollment secret during the installation process. You can retrieve the enrollment secret from the SecurityHive dashboard by clicking Manage Enrollment Secret.

Step 1: Navigate to Vulnerability Management

  1. Log in to your SecurityHive dashboard.

  2. Click on Vulnerability Management in the main menu.

  3. In the submenu, select Agents.

Step 2: Download the Agent

  1. On the Agents page, look for the Download Agent button in the top-right corner.

  2. Click Download Agent. A dropdown menu appears with multiple operating system options.

  3. Select your desired OS (e.g., Windows, macOS, Linux (deb), or Linux (rpm)).

  4. For Windows, for example, a .msi file will start to download.

Step 3: Install the Agent & Enter the Enrollment Secret

Windows Example (Manual)

  1. Locate the downloaded .msi file (e.g., in your Downloads folder) and double-click to open.

  2. Follow the installer prompts. When you reach the License Agreement, click Agree (or a similarly labeled button).

  3. The installer will ask for your Enrollment Secret.

    • Go back to the SecurityHive dashboard in your browser.

    • Next to Download Agent, click Manage Enrollment Secret.

    • Copy the enroll secret to your clipboard.

  4. Paste the enroll secret into the installer window.

  5. Click Next (or Finish, depending on the installer) to complete the setup.

Windows Example (MDM)

The SecurityHive Agent supports installation via MDM. Use the following command as example for your specific MDM tool:

msiexec.exe /i securityhive-agent.msi /qn ENROLLMENT_SECRET=YOUR_ENROLLMENT_SECRET

Available variables

Variable

Example value

Description

ENROLLMENT_SECRET

w98fytzxguyx7

The secret that allows you to enroll agents to your organization.

UPDATE_CHANNEL

unstable (default)

Define the update channel you want to use.

DISABLE_BUG_REPORTING

true or false (default)

Enable/disable bug reporting to SecurityHive platform

LOG_FILE

Path to logs of agent

DEBUG

true or false (default)

Enable debug logging

Step 4: Verify the Installation

  1. After the installation completes, return to the SecurityHive dashboard.

  2. Refresh the Agents page.

  3. The newly installed agent should now appear in the list, indicating a successful installation.

Troubleshooting

  • Incorrect or Missing Enrollment Secret: Double-check you have the right enrollment secret from Manage Enrollment Secret. If the secret is incorrect, the agent won’t register.

  • Expired Enrollment Secret: Your Enrollment Secret has expired. Please retrieve the latest one from the SecurityHive Platform.

  • Installation Fails or Freezes: Ensure you have administrative privileges and that no conflicting security software is blocking the installer.

  • Agent Not Showing Immediately: It may take a few seconds for the agent to appear. Wait briefly and refresh the page again.

Related Articles
Install Virtual Appliance
Public BETA Vulnerability Agent
Did this answer your question?