Skip to Content
DocsApplicationsFile ManagementResilio Sync
Resilio Sync

Resilio Sync

Peer-to-peer file synchronization built on the BitTorrent protocol, managed and sandboxed by QuickBox Pro.

Resilio Sync (Btsync)

Resilio Sync (formerly BitTorrent Sync / Btsync) is a proprietary, peer-to-peer file synchronization tool that uses the BitTorrent protocol to keep folders in sync across multiple devices. On QuickBox Pro, Resilio Sync is deployed as a managed service with nginx reverse proxy, opinionated storage paths, and CLI-driven lifecycle management via the qb framework.

When to Use Resilio Sync

Symptoms

  • Need to keep large media or data folders synchronized between multiple servers or desktops
  • Prefer peer-to-peer sync without relying on centralized cloud storage providers
  • Want LAN-speed transfers with end-to-end control over your files
  • Need a sync solution that can run continuously on a QuickBox Pro host

Resolution

  • Use Resilio Sync to mirror libraries between QuickBox and other devices
  • Avoid third-party cloud storage and keep data on hardware you control
  • Leverage the BitTorrent protocol for efficient, swarm-based transfers
  • Manage the service lifecycle using the QuickBox qb CLI and systemd integration

Key Features on QuickBox Pro

📁 Opinionated Storage Paths

Default storage path at /home/USERNAME/Resilio Sync/storage with managed PID directory under /run/USERNAME.

✅ EULA Acceptance

QuickBox pre-configures agree_to_EULA=yes in the JSON config, so the service can start non-interactively.

🔒 Local-Only Web UI Binding

The web UI listens on 127.0.0.1:PORT and is exposed securely via nginx, not directly on the public interface.

⚙️ Systemd Service Management

Dedicated systemd unit for Resilio Sync with PID tracking and QuickBox integration for status and control.

🌐 Reverse Proxy via nginx

nginx configuration is provisioned for you, enabling SSL termination and friendly URLs from your QuickBox host.

🛠️ qb CLI Integration

Install, reinstall, update, and remove Resilio Sync using a single unified QuickBox CLI interface.

Proprietary Software Notice

Resilio Sync is proprietary software. By installing it, you agree to Resilio’s End User License Agreement (EULA). QuickBox sets “agree_to_EULA”: “yes” in the generated configuration to allow automated deployment.

Installation

Prerequisites

  • A running QuickBox Pro v3 environment
  • A valid QuickBox system username you want Resilio Sync to run under
  • Sufficient disk space in that user’s home directory for synchronized data

User-Specific Installation

Resilio Sync is installed per QuickBox user. Each user can run their own instance with isolated configuration and storage paths.

Install Resilio Sync

Install Btsync (Resilio Sync) for a specific user:

qb install btsync -u username

This will:

  1. Create the Resilio Sync storage path under /home/username/Resilio Sync/storage
  2. Generate a user-scoped configuration JSON with EULA acceptance and web UI bind address
  3. Register and start the Resilio Sync systemd service for that user
  4. Configure nginx to reverse proxy the web interface from a QuickBox-managed port
CommandDescription
qb install btsync -u usernameInstall Resilio Sync for the specified user
qb reinstall btsync -u usernameReinstall while preserving configuration
qb remove btsync -u usernameRemove Resilio Sync and clean up all files
qb update btsync -u usernameUpdate Resilio Sync to the latest version

CLI Options

-u, --usernameRequired

Target QuickBox username for install/remove/update operations

Configuration Details

QuickBox ships a baseline configuration JSON for each user under their Resilio Sync directory. A simplified example:

{
  "listening_port": 0,
  "storage_path": "/home/USERNAME/Resilio Sync/storage",
  "pid_file": "/run/USERNAME/sync.pid",
  "agree_to_EULA": "yes",
 
  "webui": {
    "listen": "127.0.0.1:PORT"
  }
}

Key Fields

  • listening_port: 0 lets Resilio Sync choose a random high port for peer communication.
  • storage_path: Root path for internal state and auxiliary files. QuickBox uses /home/USERNAME/Resilio Sync/storage.
  • pid_file: PID file path for the systemd service, stored under /run/USERNAME.
  • agree_to_EULA: Set to "yes" to indicate acceptance of the Resilio EULA.
  • webui.listen: Binds the web UI to 127.0.0.1:PORT, where the port is assigned by QuickBox during deployment and proxied via nginx.

Template Placeholders

Values like USERNAME and PORT are substituted by the QuickBox build system during installation. They are automatically replaced with the correct username and port and should not be edited directly in templates.

Service Management

Resilio Sync runs as a systemd service managed by QuickBox. A typical unit file looks similar to:

[Unit]
Description=Resilio Sync service for QuickBox user
After=network-online.target
 
[Service]
Type=simple
User=USERNAME
Group=USERNAME
PIDFile=/run/USERNAME/sync.pid
Restart=on-failure
 
[Install]
WantedBy=multi-user.target

Common Commands

Check service status:

sudo systemctl status resilio-sync.service

Restart the service:

sudo systemctl restart resilio-sync.service

Enable service on boot:

sudo systemctl enable resilio-sync.service

View live logs:

journalctl -u resilio-sync.service -f

Multiple Users

If you run Resilio Sync for multiple QuickBox users, each instance will have its own configuration and storage path. Use the qb CLI with the appropriate -u username and check logs per service instance as documented in your QuickBox dashboard.

Accessing the Web UI

Once installed, Resilio Sync’s web interface is exposed via nginx through your QuickBox host. Exact URLs and ports may vary depending on your configuration, but the common patterns are:

  • https://your-domain.tld/resilio (path-based)
  • https://resilio.your-domain.tld (subdomain, if configured)

Local Bind, Public Proxy

The web UI listens only on 127.0.0.1. External access is provided exclusively through nginx with SSL support and QuickBox hardening. Avoid changing the bind address in the JSON config unless you fully understand the security implications.

Best Practices

Do

  • Use separate folders per purpose—create dedicated Resilio Sync shares for media libraries, configuration backups, and documents instead of one giant folder.
  • Keep sync targets inside your home or data volumes to avoid permission issues.
  • Monitor disk usage regularly, especially when syncing to smaller VPS plans.
  • Always access the web UI over HTTPS via QuickBox-managed nginx.

Don't

  • Do not point Resilio Sync at system directories like /etc, /var, or /opt.
  • Do not share keys with untrusted devices or users—anyone with a key can replicate the corresponding data.
  • Do not change the web UI bind address from 127.0.0.1 unless you understand the security implications.
  • Do not manually edit QuickBox-managed config templates in /opt/quickbox/config.
File Management Overview

High-level overview of file management tools available on QuickBox Pro.

Nextcloud

Full-featured file sync and share platform with web UI and mobile apps.

Syncthing

Open-source, peer-to-peer file synchronization alternative to Resilio Sync.

File ManagementDuplicati