Help Center


Installing Sync package on Linux


This guide implies understanding of how Linux package manager, running processes and startup work.

Upgrade from BitTorrent Sync

If you have btsync package installed and running, stop it before installing resilio-sync. 
All settings from btsync will be moved to resilio-sync. 

Before updating from btsync to resilio-sync check the size of /var/lib/btsync folder and ensure that your PC has enough free space to store the double of it. 
If it's too big, you can safely delete sync.log (and its archive) and journals. 

 

If you DO NOT have btsync package installed, ignore the note above and proceed to installing resilio-sync package. Installing resilio-sync package on Raspberry Pi devices follow the same installation steps (with one extra step for RPI1 - see below).

There are 3 ways to install it: manually, from repository and using official docker image. 

 

INSTALLING MANUALLY

Use it when released version is not pushed to repository (not all releases are). Download the proper package (according to your platform):

DEB: x64 arm64 i386 armel armhf

RPM: x86_64 i386 arm armhf armhfp armv7l armv7hl aarch64

And install it:

DEB:

sudo dpkg -i <resilio-sync.deb>

RPM:

sudo rpm -i <resilio-sync.rpm>

See section Manage below to learn how to use it further. 

 

INSTALLING FROM REPOSITORY

To install Sync from Resilio repository, you need to complete 3 steps:

  1. Add repository
  2. Add GPG public key for package verification. Package manager verifies who created a package using its digital signature
  3. Install the package using your package manager commands

Before installing Resilio Sync package, stop resilio-sync service if it's running.

 

For Debian-based Linux (Debian, Ubuntu, Mint, Zorin, Elementary)

Create file /etc/apt/sources.list.d/resilio-sync.list to register Resilio repository:

echo "deb http://linux-packages.resilio.com/resilio-sync/deb resilio-sync non-free" | sudo tee /etc/apt/sources.list.d/resilio-sync.list

Add public key with the following command:

curl -LO http://linux-packages.resilio.com/resilio-sync/key.asc && sudo apt-key add ./key.asc
For Raspberry Pi 1
sudo dpkg --add-architecture armel
sudo apt-get update
sudo apt-get install resilio-sync:armel


Update packages index and install Sync

sudo apt-get update
sudo apt-get install resilio-sync

 

For RPM-based Linux (Red Hat, Fedora, CentOS, OpenSUSE)

For OpenSUSE:

curl -LO https://linux-packages.resilio.com/resilio-sync/key.asc && sudo rpm --import key.asc

zypper ar --gpgcheck-allow-unsigned-repo -f https://linux-packages.resilio.com/resilio-sync/rpm/\$basearch resilio-sync

Create /etc/yum.repos.d/resilio-sync.repo to register Resilio repository:

printf "[resilio-sync]\nname=Resilio Sync\nbaseurl=https://linux-packages.resilio.com/resilio-sync/rpm/\$basearch\nenabled=1\ngpgcheck=1\n" | sudo tee /etc/yum.repos.d/resilio-sync.repo

Add public key:

sudo rpm --import https://linux-packages.resilio.com/resilio-sync/key.asc

Install Sync:

sudo yum install resilio-sync

Update Sync:

sudo yum check-update
sudo yum update resilio-sync 

 

INSTALLING FROM OFFICIAL DOCKER IMAGE

Follow the guide from our official Docker hub page.

 

MANAGING SYNC

Systemd

Enable Sync service automatic startup under rslsync user:

sudo systemctl enable resilio-sync

rslsync user with minimum privileges is used by default by security reasons. Thus if you need to synchronize files owned by current user - just add rslsync user to group of your current user and ensure read-write permissions for the mentioned group for the folder to be synced, for example:

sudo usermod -aG user_group rslsync
sudo chmod g+rw synced_folder

where user_group is a group name of current user, by default it's the same as user name (can be checked by running id command), synced_folder - path to the folder to be added to Sync.

If you want to run Sync under your current user - edit file /usr/lib/systemd/user/resilio-sync.service and change "WantedBy=multi-user.target" to "WantedBy=default.target". Save this file and then enable the service with --user parameter:

sudo systemctl --user enable resilio-sync

Systemctl can be also run with the following arguments: start, stop, enable, disable, status

For example, to start Sync under current user:

systemctl --user start resilio-sync

To force the user session to be active on headless linux, you can use command:

sudo loginctl enable-linger username

Upstart, SysV init

Run as rslsync user:

sudo service resilio-sync start 

Service can also be run with the following arguments: start, stop, restart

Removing the package

For Debian-based Linux: 

sudo apt-get purge resilio-sync

For RPM-based Linux:

sudo yum remove resilio-sync

 

***

Guide on how to use Sync on Linux is here.

Guide on how to run Sync in configuration mode.

Supported platforms are specified here.

 

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 or click here.