Installing a Linux Agent

This document provides instructions on how to set up and install a Linux-based On-Premises Agent to use with Liongard.


Supported Distributions

Currently, the Linux Agent only officially supports Ubuntu and Red Hat. Although most of the data collection is generic to any Linux distribution, thus far testing has only been completed on Ubuntu and Red Hat.


API Access Token

When generating a Liongard Access Token for Linux Agent installation you must select the Liongard API Token option. Currently the Agent Install Token is not compatible with our Linux Agent.

Installing the Agent:


What user should I run the Agent as?

We recommend using a normal local user with sudo access on the system and not running as root.

  • Log in to the Linux system
  • Copy the following script over to the Linux system. Fill out the top-level parameters and save in a file called, ""
    • INSTANCE = Your Liongard instance. You only need to include the first part of the subdomain, "" is assumed
    • AGENT_NAME = The name you wish to give to the Agent
    • DESCRIPTION = An optional description to give to the Agent
    • ACCESS_KEY = Your Access Key from Liongard
    • ACCESS_SECRET = Your Access Secret from Liongard
    • SERVICE_PROVIDER = The name of your company as it appears in the top left corner of your Liongard instance
    • ENVIRONMENT = The name of the Environment in Liongard to associate the Agent to
      • Note: You can remove --environment $ENVIRONMENT from Line #12 below if you wish to associate the Environment via the Liongard UI later
    • USER = The username of the user on the system you wish to run the Agent as
  • Run chmod 775
  • Run sudo ./
DESCRIPTION="This agent is for XXX"
curl -k https://$ -o setup-roar-agent
chmod 775 setup-roar-agent
sudo -u $USER ./setup-roar-agent --url "$" --name "$AGENT_NAME" --description "$DESCRIPTION" --access-key $ACCESS_KEY --access-secret $ACCESS_SECRET --service-provider "$SERVICE_PROVIDER" --environment "$ENVIRONMENT"

Downloading the Agent Install Script Manually (Note: You can usually skip this step.)

  • Log in to Liongard
  • Click on the Admin menu and select Agents
  • Hover over the Download Agent Installer button in the top-right corner and select Linux
  • You can either download the install script by clicking on the Download Setup-Roar-Agent button or copy the curl command to download it in the Shell.


  • Do I need to allowlist specific URLs?

Yes. You must allowlist and as well as your Liongard instance in order to download and install the Agent successfully.

For further information about allowlisting URLs with the Agent, please visit the Deployment via MSI Installer document under the Allowlisting Requirements

  • Do you support all Linux distributions and versions?

We have attempted to support across all versions and distributions. However, most of the testing has been done on Ubuntu and Red Hat. If you encounter problems on a specific distribution, please Support Portal: Chat with Support.

  • What if I need to uninstall a Linux Agent?

Step 1. Download the uninstall script with the following command

curl -k -o uninstall-roar-agent

Step 2. Open terminal in uninstall script location and run the following command

chmod +x uninstall-roar-agent

Step 3. Finally, run the following command

sh -e uninstall-roar-agent

Did this page help you?