The Freshservice Discovery Agent can be installed on your Windows machines. The Discovery Agent then collects the machines' hardware and software information and updates Freshservice regularly without needing further intervention from the respective users.


To install the Freshservice Discovery Agent, follow these simple steps:

  1.  Go to Admin > Asset Management > Discovery.

  2. In the Download Agent section, select Windows and click the Download Agent button.

  3. Copy the registration token which will be used in the installation process. 



    Note: 
    a)  This is applicable starting with the Windows Agent version 3.5.0.
    b) The registration token is unique to your Freshservice account and not bound to any specific discovery agent.


  4. Once the download is complete, double-click on the downloaded .msi file to launch the installer.

  5. Follow the on-screen instructions and paste the registration token to complete the installation process.

    The installation path for Freshservice Discovery Agent is C:\Program Files (x86)\Freshdesk\Freshservice Discovery Agent

If your organization has a Proxy configured, follow the below steps to install the Freshservice Discovery Agent:

  1. Download the Agent file for Windows from Admin >  Asset Management > Discovery.

  2. Open a command prompt and execute the following command:

msiexec /i <agent installer> REGISTRATIONTOKEN="dummytoken" PROXYSERVER=<proxy server name/ip> PROXYPORT=<proxy port> PROXYUSERNAME=<proxy user name> PROXYPASSWORD=<proxy password>


Example:


msiexec /i "fs-windows-agent.msi" /qn /norestart ACTION=INSTALL ALLUSERS=1 TARGETDIR="C:\Program Files (x86)\Freshdesk\Freshservice Discovery Agent\" REGISTRATIONTOKEN="dummytoken" PROXYSERVER=192.168.5.161 PROXYPORT=808 PROXYUSERNAME=admin PROXYPASSWORD=freshservice

Note : PROXYUSERNAME and PROXYPASSWORD are optional.



Discovery agent silent installation via command:

Silent/unattended installation command:
  msiexec /i "fs-windows-agent.msi" /qn /norestart ACTION=INSTALL ALLUSERS=1 TARGETDIR="C:\Program Files (x86)\Freshdesk\Freshservice Discovery Agent\" REGISTRATIONTOKEN="<token>"

 Replace the <token> with the registration token value copied from Admin > Asset Management > Discovery 

Silent/unattended installation command with proxy:
  msiexec /i "fs-windows-agent.msi" /qn /norestart ACTION=INSTALL ALLUSERS=1 TARGETDIR="C:\Program Files (x86)\Freshdesk\Freshservice Discovery Agent\" REGISTRATIONTOKEN="<token>" PROXYSERVER=<value> PROXYPORT=<value> PROXYUSERNAME=<value> PROXYPASSWORD=<value>

 Replace the <value> with the corresponding proxy properties



More information on the Agent (supported OS, Prerequisites, download instructions... etc.) can be found here.

To install the Discovery Agent on computers in a workgroup, use the PSExec tool.

To install the Discovery Agent on computers in a domain, use GPO