This guide implies understanding of how Linux package manager, running processes and startup work.
Installing Sync package on Linux
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
Download the proper package (according to your platform):
| Resilio Sync v3.x | Resilio Sync v2.8.1 | ||
|
DEB |
RPM |
DEB |
RPM |
Install it using the built in package manager:
-
DEB:
sudo dpkg -i <resilio-sync.deb>
-
RPM:
sudo yum install <resilio-sync.rpm>
See section Manage below to learn how to use it further.
Installing From Repository
Version and usage compatibility
If you use Resilio Sync for personal non-commercial usage, you can update to and install Resilio Sync v3If you use Resilio Sync Business, please continue using Resilio Sync v2. The latest available version is 2.8.1, download links for manual installation are available from the tab on the left.
Important: Do not attempt to update your current Resilio Sync Business installation to Resilio Sync v3, it is not supported and access to the configured shares might be lost. Reinstalling of Sync will be required.
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
For the latest distributions, add public key with the following command:
wget -qO- https://linux-packages.resilio.com/resilio-sync/key.asc | sudo tee /etc/apt/trusted.gpg.d/resilio-sync.asc > /dev/null 2>&1
For older distributions, e.g. Ubuntu 20.04, add public key with the following command:
curl -L https://linux-packages.resilio.com/resilio-sync/key.asc | sudo apt-key add
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
N: Skipping acquire of configured file 'non-free/binary-i386/Packages' as repository 'http://linux-packages.resilio.com/resilio-sync/deb resilio-sync InRelease' doesn't support architecture 'i386'
For RPM-based Linux (Red Hat, Fedora, CentOS, OpenSUSE)
For OpenSUSE:
Add public key:
sudo rpm --import https://linux-packages.resilio.com/resilio-sync/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
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
Default Sync service settings
By default Sync is running under rslsync user with minimum privileges for security reasons. To enable automatic startup of Sync service under rslsync user:
sudo systemctl enable resilio-sync
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 usermod -aG rslsync user_name
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, user_name - name of the current user.
Alternative: Running Sync under the current user
If you want to run Sync under your current user, first disable auto-launch of Sync and stop it:
sudo systemctl disable resilio-sync
sudo systemctl stop resilio-sync
Then, edit the 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 auto-start of service with --user parameter:
systemctl --user enable resilio-sync
To start Sync under the current user execute:
systemctl --user start resilio-sync
Systemctl can be also run with the following arguments: start, stop, enable, disable, status
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.