Help Center

Desktop Agent Installation (silent) and connecting it to Management Console


Important: do not attempt to connect Sync or Sync Pro from our official website to Resilio Connect Server. Also, do not use Connect Agent folders in Sync or Sync Pro

With Resilio Connect you need to generate a custom client configuration which, upon installation, will attempt to connect directly to the Connect Server. The procedure for this is outlined below.

Open the Connect Server console, go to Settings -> General and generate a client configuration file. 

1.png

 

Adjust the fields in the config:edit the server's IP address, if necessary, or put there the server's DNS address; you can also regenerate the bootstrap token if it expired or got compromised; if necessary, edit default storage path.  

2.png

Download sync.conf file and deliver it to Resilio Connect Agents. 

Follow the below mentioned instructions to install and connect Agents to the Management Console.

 

Windows

*Silent installation is covered below. 

  1. Before installing, place the “sync.conf” file into the same folder as the downloaded MSI installer (Make sure to pick the MSI suitable for your Windows OS version). 
  2. If, for a reason, there is no possibility to get the sync.conf, run installer as it is, proceed to the steps and configure connection manually: fill in Server's IP address, copy-paste bootstrap token and certificate fingerprint, and change default folder path if necessary. 

 

Once installed, the Resilio Connect Agent will immediately pick up the config file and attempt to connect to Resilio Server.

* For silent installation use the following parameters for msiexec.exe utility 

msiexec.exe /i Filename.msi /passive SERVICE_USER="Local System" CONFIG_SRC_PATH="C:\path\to\config\Downloads\"

Flag SERVICE_USER="Local System" can be used to specify service installation under System. Otherwise, can be omitted, and service will be installed as Local Service by default. 

Flag CONFIG_SRC_PATH="C:\path\to\config\Downloads\" is necessary to point the service to the config file downloaded from Server. Note the trailing slash in the path, and make sure that config is named sync.conf exactly. 

 

OS X

  1. Open the downloaded “resilio-connect-agent.dmg” package, drag the "Resilio Connect" app to the "Applications" folder and launch from there.
  2. On the appeared view either pick the sync.conf file, delivered here from Server; or, if you don't have it for a reason, manually generate it: fill in Server's IP address, copy-paste bootstrap token and certificate fingerprint, and change default folder path if necessary. 

3.png

On OS X, Agent runs under user account and will only launch upon login.

Linux

  1. Unpack the Agent package to your preferred location
  2. Put the sync.conf file into your preferred location
  3. Ensure that Agent is started up when necessary with the following arguments:
    ./rslagent --config <path_to_sync.conf>

Please note that on Linux, files created by Resilio Connect are owned by the user running the “rslagent” process and with its umask. It is unaware of any ACLs applied to your filesystem and will use POSIX.1 permissions.

Resilio Connect can be installed on low-profile Linux devices in the same manner, though please refer to this article for limitations applied to low-profile devices.

NAS

Resilio Connect Agent is not pre-packaged for any particular NAS platform and is supplied as binary. Therefore, Agent installation on a NAS platform will require Linux administration skills as well as knowledge of your NAS internals. There are certain limitations concerning how Agent runs on NASes, therefore please refer to this article for more information.

  1. SSH to your NAS.
    Please note that some vendors restrict SSH access to the NAS and enabling it may void your warranty.
  2. Find proper location for your Resilio Connect Agent and put the binary there.
    Please note that some vendors may wipe out /opt folder during reboot and/or NAS upgrade so it is better to put your Resilio Connect Agent to some location vendor designated for 3rd party applications. For example, Synology stores installed packages in /volume1/@appstore
  3. Deliver sync.conf from server and put it into appropriate directory on your NAS
  4. Add the parameter "storage_path" to sync.conf and point it to the location where Resilio Connect Agent will store its service data. The user running the Agent will require full access permissions to the location.
  5. Ensure that Agent is started up when necessary with the following arguments:
    ./rslagent --config <path_to_sync.conf>
    Note that some NAS vendors re-image standard Linux startup scripts (like /etc/rc.local)
Was the article helpful? Yes / No, send feedback on article Thanks!


Please note that we won't mail you back. This is just purely feedback on the article above. If you need help from our Support Team, please use the "Contact Support" link at the top of the page.