Update Resilio Agents

Update order

Update your Management Console and private tracker server (if applicable) prior to updating Agents.

To update Agents download the appropriate installer and follow the steps below.

Note

Agents will remain in their groups after the update.

WindowsLinuxmacOS

To update Resilio Agent on Windows:

Stop the Resilio Connect Agent service and close the Agent UI.
Download the Resilio Connect Agent MSI installer.
Launch the MSI installer and follow the installation wizard.

MSI and network shares

Do not launch the MSI installer from a network share. This will cause the installer to fail.
Click OK to relaunch Windows Explorer.

After the update is complete, the Agent will resume operating as it was originally configured.

Tarball archive

To update an Agent installed via a tarball archive:

Stop current Agent process.
- Agent installed through a plain binary file: sudo killall rslagent
- Agent registered as daemon: sudo systemctl stop resilio-agent
  
  Daemon name
  
  The daemon name may vary.
Download the Agent's tar archive and unpack it to the same directory where the rslagent binary is located.
```
tar zxf resilio-connect-agent_x64.tar.gz -C /home/vboxuser/apps/resilio-agent
```
Start the Agent service.
```
./rslagent
```

Successful update conditions

To successfully update the Agent while preserving the current settings, the following conditions must be met:

The new Agent should use the same settings as the old version
Settings are stored in the .sync directory in the current location (pwd) from where the process is launched. The updated Agent must also be launched from the same directory.
The Agent must have read-write access to the settings and shared files. If necessary, adjust the POSIX permissions.

DEB package

Note

This procedure is applicable to Agents installed using a DEB package and it assumes that there already is a Resilio repository file and a registered PGP key.

To update an Agent installed on a Debian-based Linux via a DEB package:

Add the following line to the /etc/apt/sources.list.d/resilio-agent.list file. Make sure to replace X.Y with the version number you're updating to - for example, 4.2, 5.0.
```
deb http://linux-packages.resilio.com/resilio-agent-X.Y/deb resilio-agent non-free
```

Update your repository and the agent:

sudo apt-get update  
sudo apt-get install --only-upgrade resilio-agent

RPM package

Note

This procedure is applicable to Agents installed using an RPM package and it assumes that there already is a Resilio repository file and a registered PGP key.

To update an Agent installed on a Red Hat-based Linux via an RPM package:

Add the following to /etc/yum.repos.d/resilio-agent.repo. Make sure to replace X.Y with the version number you're updating to - for example, 4.2, 5.0.
```
[resilio-agent-X.Y]
name=Resilio Agent $basearch
baseurl=http://linux-packages.resilio.com/resilio-agent-X.Y/rpm/$basearch
enabled=1
gpgcheck=1
```
Update the Agent:
```
sudo yum update resilio-agent
```

To update Resilio Agent on macOS:

Download the Resilio-Connect-Agent.dmg image file.
Stop the current Agent process and launch the downloaded package.
Move it to the Applications folder and choose to replace the existing item.
Start the Agent.

After the update is complete, the Agent will resume operating as it was originally configured.