The FreeBSD agent has the following features, which can be selectively enabled:

  • Automation: Runbook automation, remote script execution, and custom script monitoring
  • RemoteCommand: Remote command execution
  • RemoteConsole: Remote device access

By default, all features are enabled.

The agent download file name format is opsramp-agent-{version}.{osType}.{packageType} where:

  • version: OpsRamp version
  • osType: 32-bit or 64-bit
  • packageType: Installation package format

For example, opsramp-agent-9.0.0-1_freebsd10-amd64.txz

After the agent is installed, the agent automatically begins sending telemetry to OspRamp.


  • Processor: 1 GHz CPU or greater
  • Memory: 2 GB RAM
  • Disk Space: 200 MB

For x64-bit, the agent supports for the following operating system versions:

  • FreeBSD 10.x
  • FreeBSD 11.x
  • FreeBSD 12.x

Download and install a root user agent

  1. From All Clients choose a client.

  2. In the Dashboard menu, navigate to Setup > Download > Agent.

  3. In the FreeBSD tile, select the operating system version from drop-down list.

  4. Follow the dialog to download and save the agent installer. Agent installation with a non-root user is not supported.

  5. Install the agent: For example: 64 bit,

        pkg add opsramp-agent-{version}_freebsd10-amd64.txz
  6. Start the agent with the authentication tokens generated for your organization, enabling the features that you want.

    • Click Instructions in the FreeBSD tile to get the authentication tokens. The -K and -S argument values in the instructions are populated for your organization.

    • Copy-and-paste the values into the command line.

    • Enable all features using the following:

            sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s -M true
    • Enable specific features:

            sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s -M true -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"

See the /tmp/opsramp-agent_install.log file for installation progress.

Download and install an agent using the deployment script

This describes how to use the Python-based deployment script to install an agent.

Check for supported operating systems.

An agent has the following features, which can be selectively enabled:

AutomationRunbook automation, remote script execution, and custom script monitoring
PatchManagementDevice patch scanning and installation
RemoteCommandRemote command execution
RemoteConsoleRemote device access

Patch Management and non-root agent installation are not supported in FreeBSD Agent.

Additional prerequisites:

  • Python is required to run the script.
  • The host machine should have access to the OpsRamp API server to download the installer.

To install a root user agent:

  1. Download and save the script.

  2. Install the agent:

    • Enable all features:

    • Enable specific features:

            python -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"

    Within a few seconds, the OpsRamp Infrastructure page displays the installed server.

Uninstall the agent

To uninstall the agent, delete the agent and the /opsramp/agent directory:

pkg delete opsramp-agent
rmdir /opt/opsramp/agent

See the /tmp/opsramp-agent_uninstall.log file for uninstall progress.


The following are limitations and unsupported agent features on a FreeBSD operation system:

  • Monitors
  • Remote commands
  • Patching


Template NameSupport
Linux Disk State (G1)No
TCP Connection Statistics (G1)No

Remote commands

NS lookupNo
Execute a commandNoExecute a command on Remote FreeBSD Server is not supported.


Missing patch requestsNo
OS patchingNo
Skip patching during device maintenanceNo