Difference between revisions of "BitTorrent Sync"

From ArchWiki
Jump to: navigation, search
(Installation: Summary of what the package does; Improve systemctl usage instructions; Tell where configuration is stored)
(Installation)
Line 27: Line 27:
 
replacing {{ic|user}} by the desired username. Configuration is located at {{ic|~/.config/btsync/btsync.conf}}, and metadata is saved in {{ic|~/.config/btsync/}} by default.
 
replacing {{ic|user}} by the desired username. Configuration is located at {{ic|~/.config/btsync/btsync.conf}}, and metadata is saved in {{ic|~/.config/btsync/}} by default.
  
If you prefer to run it as the {{ic|btsync}} system user, leave the {{ic|@user}} part out:
+
If you prefer to run it as the {{ic|btsync}} system user you will need to create a config:
 +
#  sudo -ubtsync /usr/share/bittorrent-sync/btsync-makeconfig.sh | sudo -uroot tee /etc/btsync.conf
 +
Now start the service and leave the {{ic|@user}} part out:
 
  # systemctl enable btsync
 
  # systemctl enable btsync
 
  # systemctl start btsync
 
  # systemctl start btsync

Revision as of 18:11, 18 September 2013

BitTorrent Sync (BTSync) is a file sharing system that relays on the BitTorrent protocol, and differs from other file sharing software in the connection type between devices. Instead of uploading the files to an online server, and then each device fetching them from the server itself, the file transfer is done directly from peer to peer, and therefore there is no limit on data storage and/or transfer speed.

Security

BitTorrent Sync encrypts the traffic between devices with AES cypher and a 256-bit key created on the base of the secret — a random string (20 bytes or more) that is unique for every folder to be synchronized.

Secrets

BitTorrent Sync uses a specific method for folder sharing, the 'secret': a random 21-byte key Base32-encoded.

Synchronization

When a device makes a folder and adds it to his BTSync client, a secret is generated. From now on, every device that wants to synchronize that folder, must know the secret key.

The synchronization has no speed or size limits, as long as both devices have enough disk space.

Installation

bittorrent-syncAUR can be installed from the AUR. The package includes systemd service definitions, which will create default config files automatically if they do not exist when the service starts.

Alternatively, the bare 'tar.gz' packaged executable is downloadable from the official website.

Once installed, enable and initialize the service:

# systemctl enable btsync@user
# systemctl start btsync@user

replacing user by the desired username. Configuration is located at ~/.config/btsync/btsync.conf, and metadata is saved in ~/.config/btsync/ by default.

If you prefer to run it as the btsync system user you will need to create a config:

#  sudo -ubtsync /usr/share/bittorrent-sync/btsync-makeconfig.sh | sudo -uroot tee /etc/btsync.conf

Now start the service and leave the @user part out:

# systemctl enable btsync
# systemctl start btsync

Configuration for this user is located at /etc/btsync.conf, and metadata is saved in /var/lib/btsync/ by default.

The Linux client of BTSync does not use a typical GUI; it sets up a WebUI server accessible in localhost:8888, with the default login credentials as the user set in the service starting process, and the password password.

Configuration

The web-server has the built-in configuration settings also available in other platforms.

For further configuration, the ~/.config/btsync/btsync.conf file contains advanced parameters; for example, the possibility to use a password other than the default one (recommended, of course).