Open Source Continuous File Synchronization
Go to file
Matt Burke 2234c45c19 Decouple connections service from model
The connections service no longer depends directly on the
syncthing model object, but on an interface instead. This
makes it drastically easier to write clients that handle
the model differently, but still want to benefit from
existing and future connections changes in the core.

This was motivated by burkemw3's interest in creating a
FUSE client that can present a view of the global model,
but not have all of the file data locally.

The actual decoupling was done by adding a connections.Model
interface. This interface is effectively an extension of the
protocol.Model interface that also handles connections
alongside the modified service.
2015-09-25 12:19:30 -04:00
assets Add .gitattributes; normalize line endings 2015-04-25 23:16:46 +09:00
cmd Decouple connections service from model 2015-09-25 12:19:30 -04:00
etc Update etc/linux-systemd/README.md 2015-09-10 21:04:52 +02:00
Godeps Clean up deps 2015-09-22 19:39:07 +02:00
gui New global discovery protocol over HTTPS (fixes #628, fixes #1907) 2015-09-20 21:10:53 +02:00
lib Decouple connections service from model 2015-09-25 12:19:30 -04:00
man Translation & docs update 2015-08-30 14:38:47 +02:00
protocol The protocol specs moved again 2015-01-09 08:54:19 +01:00
script Add specific build setup for CircleCI 2015-09-02 14:56:16 +02:00
test Fix import paths 2015-09-22 19:38:46 +02:00
.gitattributes Revert "Enforce line endings when cloning (fixes #1766)" 2015-05-07 22:55:31 +02:00
.gitignore Remove leftovers from signing 2015-08-31 17:46:48 +02:00
.mailmap Include ref#, show author nickname in release notes 2014-12-07 12:52:18 +01:00
appveyor.yaml Add AppVeyor for Windows builds 2015-09-20 15:18:50 +02:00
AUTHORS Add my email to AUTHORS as well 2015-09-10 21:23:38 +02:00
build.go Remove leftovers from signing 2015-08-31 17:46:48 +02:00
build.sh Signing is done by stsigtool only 2015-08-30 20:50:07 +02:00
CONDUCT.md Add Code of Conduct 2014-12-02 15:57:31 +01:00
CONTRIBUTING.md Links are nice, too 2015-06-10 00:04:53 +02:00
LICENSE MPLv2 2015-03-17 16:02:27 +01:00
NICKS Add my "community email address" to NICKS 2015-09-10 21:14:22 +02:00
README.md Add AppVeyor for Windows builds 2015-09-20 15:18:50 +02:00

Syncthing

Latest Build (Official) AppVeyor Build API Documentation MPLv2 License

This is the Syncthing project which pursues the following goals:

  1. Define a protocol for synchronization of a folder between a number of collaborating devices. This protocol should be well defined, unambiguous, easily understood, free to use, efficient, secure and language neutral. This is called the Block Exchange Protocol.

  2. Provide the reference implementation to demonstrate the usability of said protocol. This is the syncthing utility. We hope that alternative, compatible implementations of the protocol will arise.

The two are evolving together; the protocol is not to be considered stable until Syncthing 1.0 is released, at which point it is locked down for incompatible changes.

Getting Started

Take a look at the getting started guide.

There are a few examples for keeping Syncthing running in the background on your system in the etc directory.

There is an IRC channel, #syncthing on Freenode, for talking directly to developers and users.

Building

Building Syncthing from source is easy, and there's a guide. that describes it for both Unix and Windows systems.

Signed Releases

As of v0.10.15 and onwards, git tags and release binaries are GPG signed with the key D26E6ED000654A3E (see https://syncthing.net/security.html). For release binaries, MD5 and SHA1 checksums are calculated and signed, available in the md5sum.txt.asc and sha1sum.txt.asc files.

Documentation

Please see the Syncthing documentation site.

All code is licensed under the MPLv2 License.