This guide implies understanding of how Linux package manager, running processes and startup work.
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.
Use it when released version is not pushed to repository (not all releases are). Download the proper package (according to your platform):
And install it:
sudo dpkg -i resilio-sync.deb
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, 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:
wget -qO - https://linux-packages.resilio.com/resilio-sync/key.asc | sudo apt-key add -
Also you can use the following command to add public key:
curl -LO http://linux-packages.resilio.com/resilio-sync/key.asc && sudo apt-key add ./key.asc
|For arm64 architecture||For Raspberry Pi 1|
In /etc/apt/sources.list.d/resilio-sync.list change the line as follows:
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)
Important: only arm and x64 archs are available.
Create file /etc/yum.repos.d/resilio-sync.repo with the following content to register Resilio repository:
Add public key:
rpm --import https://linux-packages.resilio.com/resilio-sync/key.asc
sudo yum install resilio-sync
sudo yum check-update
sudo yum update resilio-sync
INSTALLING FROM OFFICIAL DOCKER IMAGE
Follow the guide from our official Docker hub page.
Enable Sync service automatic startup under rslsync user:
sudo systemctl enable
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
user_group is a group name of current user, by default it's the same as user name (can be checked by running
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
sudo systemctl --user enable
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:
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.