Keep track of the assets by updating the device information to Freshservice by installing the Freshservice Discovery Agent for Linux on your devices with Linux OS ( with .NET Core 3.1 support).


Installing the Agent in a single machine (Without Proxy)

  1. Navigate to Admin -> Discovery

  2. In the Download Agent section, choose Linux

  3. Click Download Agent Button. A tar.gz file will be downloaded.

  4. Extract the downloaded tarball file to a folder, FS-Linux-Agent.py file will be extracted.

  5. Open a Terminal and run the FS-Linux-Agent.py file using the command to install the agent: sudo python FS-Linux-Agent.py
  6. This python installer file(FS-Linux-Agent.py) will check if .Net core runtime 3.1 or above is installed. If not it will download the latest build of .Net core runtime 3.1 and proceed with the installation.

NOTE: The supported python version is 2.7 to 3.7.

Installing the Agent in a single machine (With Proxy)

  1. Extract the downloaded tarball file to a folder, FS-Linux-Agent.py file will be extracted.

  2. Open a Terminal and run the FS-Linux-Agent.py using the proxy parameters to install the agent with proxy.  Following are the proxy parameters:
    1. --server or -s - is the host address of the proxy server.
    2. --port or -p is the proxy port number.
    3. --username or -u is the proxy username.
    4. --pasword or -k is the proxy password.
    5. -h will give the example syntax.
  3. Examples:
    1. with proxy credentials : sudo python FS-Linux-Agent.py --server <host_address> --port <port> --username <username> --password <password>
    2. without proxy credentials: sudo python FS-Linux-Agent.py --server <host_address> --port <port>

Installing the Agent on multiple machines

Since Linux has multiple versions, there is no common way to install the Linux agent on multiple machines. But some prerequisites needed will be:


  • You need the downloaded python script. 
  • At least one version between Python 2.7 to 3.7 should be installed.  

Performing Other operations

To perform other operations refer to this documentation:

https://support.freshservice.com/en/support/solutions/articles/50000002840-discovery-agent-commands-mac-linux-