Help Center

Client installation and connection to management server


Important: do not install Sync from our official website. If you're already running Sync Pro, you'll need to uninstall it if you're planning on installing the Sync IT client or Management Server on the same machine. Use only the Sync client or server supplied in the Sync IT package.

 

With Sync IT you have to create a custom client configuration which, upon installation, will attempt to connect directly to the Management Server. The procedure for this is outlined below:

  1. Open the Management Server console, go to Settings -> General -> Download client config and download the client configuration file. Rename it to “sync.conf”.
  2. Edit the “sync.conf” file and make sure that the "host" parameters contain the correct IP address and port of your Management Server
  3. Copy the “sync.conf” file to the client computer together with the client installer
  4. Follow the instructions below to determine where the config file should be placed (The location varies based on the client OS):

Windows

  1. Place the “sync.conf” file in the same folder as the MSI installer (Make sure to pick the MSI suitable for your Windows OS version)
  2. Run the MSI installer, and follow the installation instructions
  3. Once installed, the Sync IT client will immediately pick up the config file and attempt to connect to Management Server


By default, the Sync IT client runs under the "LOCAL SERVICE" account.

OS X

  1. Open the “BitTorrentSync.dmg” package
  2. Drag the "BitTorrent Sync.app" to the "Applications" folder
  3. Open Finder and navigate to the "/Users/<username>/Library/Application Support/" folder. The "Library" folder is a hidden folder, so you can use the Cmd+Shift+g shortcut to type in the path manually
  4. Create the "BitTorrent Sync IT" folder (case sensitive!)
  5. Put the “sync.conf” file in the "BitTorrent Sync" folder
  6. Open System Preferences -> Users and Groups -> Login Items. Add Sync as a login item to ensure it launches automatically.

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

Linux

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

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

Sync 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

Sync IT client is not pre-packaged for any particular NAS platform and is supplied as binary. Therefore, Sync IT Client installation on a NAS platform will require linux administration skills as well as knowledge of your NAS internals. There are certain limitations concerning how Sync 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 Sync IT Client 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 Sync IT Client 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 Sync IT Client will store its service data. The user running Sync IT Client will require full access permissions to the location.
  5. Ensure that Sync is started up when necessary with the following arguments:
    ./btsync --config <path_to_sync.conf>
    Note that some NAS vendors re-image standard Linux startup scripts (like /etc/rc.local)