From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

Syncthing is a continuous file synchronization program. It synchronizes files between two or more computers in real time. Syncthing is available on Linux, MacOS, Android, Windows and other operating systems, making it a good choice for cross platform file sharing.


USE flags

USE flags for net-p2p/syncthing Open Source Continuous File Synchronization

selinux !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur
tools Install stdiscosrv, strelaysrv and other tools to /usr/libexec/syncthing/.


root #emerge --ask net-p2p/syncthing


To view all available configuration options:

user $man 5 syncthing-config


Configuration files and security certificates, if run as a user.
Config file for /etc/init.d/syncthing



OpenRC can start Syncthing at startup:

root #rc-update add syncthing default


Syncthing can be started as a user with systemd:

user $systemctl --user enable syncthing.service
user $systemctl --user start syncthing.service



user $syncthing --help
Usage: syncthing <command>

  -h, --help    Show context-sensitive help.

    Run Syncthing

  decrypt <path>
    Decrypt or verify an encrypted folder

    Command line interface for Syncthing

Run "syncthing <command> --help" for more information on a command.

Running Syncthing

Syncthing can be started as a common user:

user $syncthing

It will create the following directories at first use:

Configuration files and security certificates.
The default folder to synchronize.

Syncthing will also fire up a browser page at for monitoring and configuration.


Changing the user of init service

User and group with which Syncthing creates and modifies the synced files, can be changed by uncommenting the following lines in /etc/conf.d/syncthing:

FILE /etc/conf.d/syncthingChanging the default user of syncthing init service

Syncing files with Android

If files are shared with Android, make sure to enable "Ignore Permissions" in the advanced tab. This option disables comparing and syncing file permissions and is useful on systems with nonexistent or custom permissions (e.g. FAT, exFAT, Synology, Android).

Headless syncthing with ssh tunnel

The easiest thing to do is reverse proxy ssh to access the config. It is in the documentation:

user $ssh -L 9090:localhost:8384 <name>@<ip>

Now the page http://localhost:9090 can be opened on the computer and make edits to the browser page.

More documentation

Syncthing provides a number of man pages:

See also

  • Rsync — a powerful file sync program capable of efficient file transfers and directory synchronization.