Help Center

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

Resilio Sync product

Please do not attempt to connect Sync or Sync Pro from our official website to Resilio Connect Server. That won't work.

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. 



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.  


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.


*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 /qn 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. 


  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.

  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. 


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

Resilio Connect Agent is pre-packaged for a few NASes, installation guides are here.  For others Agent installation  will require Linux administration skills as well as knowledge of your NAS internals. There are certain limitations concerning how Agents run on NASes, therefore please refer to this article for more information.

  1. SSH to your NAS.
    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.
    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.
  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 settings and configuration data. The user running the Agent will require full access permissions to the location. The line will be like this, verify json format after editing config:
  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.