Overview
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.
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
Use it when released version is not pushed to repository (not all releases are). Download the proper package (according to your platform):
Downloads For DEB:
Downloads For RPM:
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:
- Add repository
- Add GPG public key for package verification. Package manager verifies who created a package using its digital signature
- 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
For Ubuntu 22 and newer 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
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.
Running Sync under the current user
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:
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.