Skip to main content

Install a Frends Agent on Linux

How to install a Frends.Agent in Linux (Frends 5.5 and above)

T
Written by Tikriti Shabudin
Updated over a year ago

Installation steps

0. Prerequisites

Ensure that your machine meets the prerequisites and you have opened the necessary ports.

1. Install .NET and ASP.NET Core

Version 8.0 for Frends 5.7, version 6.0 for Frends 5.6 and 5.5. For Frends 5.4 please check this article. Follow these instructions based on your Linux distribution https://docs.microsoft.com/en-us/dotnet/core/install/linux

2. Create a new Agent in the Frends Control Panel

In the Frends Control Panel, create a new Agent Group, set it to Cross-Platform (from "Advanced settings"), and create a new Agent.

3. Download Agent binaries

Download the preconfigured binary package of the Agent by clicking "Preconfigured Linux binary package". Unzip the package wherever you want. Ensure it is downloaded in an available directory when running the commands below.

4. Check and ensure the preconfigured settings are correct

Open and review the file unzipped-agent-dir/secrets/appsettings.secrets.json

Modify if required.

5. Run deployment script

Go to the Agent directory and run these commands, line by line:

sudo chmod 700 ./Deploy-FRENDS-Agent.sh 
sudo ./Deploy-FRENDS-Agent.sh install

This deployment script will

  • copy Agent files to /opt/frends-agent-linux/

  • create a Daemon service for the Agent called frendsagent

Usage

Controlling the Agent service

sudo systemctl start frendsagent 
sudo systemctl restart frendsagent
sudo systemctl stop frendsagent
sudo systemctl status frendsagent

Checking Agent logs

tail -f /var/log/FRENDS/FRENDSAgentService.log
Did this answer your question?