Sync Hacks: Setting up BitTorrent Sync with Ansible


Sync Hacks is a column dedicated to exploring new applications for BitTorrent Sync, as built by users like you. BitTorrent Sync is a free, unlimited, secure file-syncing app. (And now, it’s 2X faster.) If you’ve got an epic Sync idea, use-case or how-to, shoot us an email at sync[at]

In this week’s Sync Hacks: Franck Cuny, a software developer at Say Media, shows us how to set up BitTorrent Sync with Ansible to access and share large files for free, from anywhere.

From Franck:

Recently, I’ve started to look at the services I’m using and I’m trying to find alternatives for some of them. One of them was Dropbox. I’ve been using this service for 4 or 5 years at this point, and I was a paid customer for at least 3 years. My plan was about to renew in a few days, and I decided to look for a free (either “doesn’t cost a buck” or OSS) alternative. To make it quick, since it’s not the purpose of this post, I’ve decided to go with Bittorrent Sync. Here’s a list of pro and cons.


• Free
• The only limit on storage is based on the free space you have
• Decentralized


• Harder to set up
• Decentralized (yes I know): you need to always have at least one node up if you want to get a copy of a file

I decided to set BitTorrent Sync on one of my servers that is always up, so that I can access my copies whenever I want from any devices (similar to Dropbox), but much cheaper. To do that I’ve create a set of tasks for Ansible, following the instructions provided by Leo Moll (who created the package for Debian) on this forum.

I’ve created a role named ‘btsync’ that contains a handler, some templates and a bunch of tasks. Let’s start with the handler, since this one is really simple. For this role, the only y service we care about is the BitTorrent Sync daemon:

- name: restart btsync
  service: name=btsync state=restarted

The tasks are pretty straightforward. First we need to fetch Leo’s PGP key so we can install the package using apt.

- name: Install GPG key for btsync

Now that we have the PGP key, we can add the repository to our sources and install the package:

- name: Add the deb repo for btsync
    repo='deb wheezy main'

- name: Install btsync
  apt: pkg=btsync state=installed

For the remaining tasks, we need some configuration.

  - dir: /path/to/shared/photos
    secret: a-secret
    use_relay_server: true
    use_dht: false
    search_lan: false
    use_sync_trash: true
  - dir: /path/to/shared/documents
    secret: another-secret
    use_relay_server: true
    search_lan: false
    use_sync_trash: true

The daemon expect all the directories that it will write to, to exist. So let’s create them for him, and also set the right permissions on them:

- name: Create the directories where we need to sync
  file: path= state=directory owner= group= mode=0700
  with_items: btsync_shared

We need a specific configuration file for our user:

- name: Configure btsync
  notify: restart btsync

and the template that goes with it:

        "device_name": "",
        "storage_path" : "/home//.btsync",
        "listening_port" : 12589,
        "check_for_updates" : false,
        "use_upnp" : false,
        "download_limit" : 0,
        "upload_limit" : 0,
        "disk_low_priority" : true,
        "lan_encrypt_data" : true,
        "lan_use_tcp" : false,
        "rate_limit_local_peers" : false,
        "folder_rescan_interval" : 600,
        "shared_folders" : 

To complete the setup, we need to tell the daemon to start with our newly created configuration:

# This is the configuration file for /etc/init.d/btsync
# Start only these btsync instances automatically via
# init script.


# Optional arguments to btsync's command line. Be careful!
# You should only add thngs here if you know EXACTLY what
# you are doing!

Finally, the task to setup the default configuration for the daemon:

- name: Configure btsync server
  notify: restart btsync

That’s it!

*This article was originally posted on Franck Cuny’s blog.

Franck Cuny (@franckcuny) is a software developer, working in the operations team of Say Media in San Francisco.