2015-09-10 12:42:07 -07:00
|
|
|
# Syncthing
|
2013-12-15 03:43:31 -07:00
|
|
|
|
2015-09-02 02:57:00 -07:00
|
|
|
[![Latest Build (Official)](https://img.shields.io/jenkins/s/http/build.syncthing.net/syncthing.svg?style=flat-square)](http://build.syncthing.net/job/syncthing/lastBuild/)
|
2015-09-20 06:18:50 -07:00
|
|
|
[![AppVeyor Build](https://img.shields.io/appveyor/ci/calmh/syncthing/master.svg?style=flat-square)](https://ci.appveyor.com/project/calmh/syncthing)
|
2015-09-02 02:57:00 -07:00
|
|
|
[![API Documentation](https://img.shields.io/badge/api-Godoc-blue.svg?style=flat-square)](http://godoc.org/github.com/syncthing/syncthing)
|
|
|
|
[![MPLv2 License](https://img.shields.io/badge/license-MPLv2-blue.svg?style=flat-square)](https://www.mozilla.org/MPL/2.0/)
|
2014-07-31 03:56:05 -07:00
|
|
|
|
2015-05-31 00:35:17 -07:00
|
|
|
This is the Syncthing project which pursues the following goals:
|
2013-12-15 03:43:31 -07:00
|
|
|
|
2014-09-28 04:39:39 -07:00
|
|
|
1. Define a protocol for synchronization of a folder between a number of
|
2015-04-10 04:20:50 -07:00
|
|
|
collaborating devices. This protocol should be well defined, unambiguous,
|
2014-09-28 04:39:39 -07:00
|
|
|
easily understood, free to use, efficient, secure and language neutral.
|
2015-09-10 12:42:07 -07:00
|
|
|
This is called the [Block Exchange Protocol][1].
|
2013-12-15 03:43:31 -07:00
|
|
|
|
|
|
|
2. Provide the reference implementation to demonstrate the usability of
|
2015-04-10 04:20:50 -07:00
|
|
|
said protocol. This is the `syncthing` utility. We hope that
|
2015-04-28 08:34:55 -07:00
|
|
|
alternative, compatible implementations of the protocol will arise.
|
2013-12-15 03:43:31 -07:00
|
|
|
|
|
|
|
The two are evolving together; the protocol is not to be considered
|
2015-05-31 00:35:17 -07:00
|
|
|
stable until Syncthing 1.0 is released, at which point it is locked down
|
2013-12-15 03:43:31 -07:00
|
|
|
for incompatible changes.
|
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
## Getting Started
|
2014-04-30 07:13:29 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
Take a look at the [getting started guide][2].
|
2014-08-19 06:33:20 -07:00
|
|
|
|
2015-05-31 00:35:17 -07:00
|
|
|
There are a few examples for keeping Syncthing running in the background
|
2015-09-10 12:42:07 -07:00
|
|
|
on your system in [the etc directory][3].
|
2014-11-24 05:47:56 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
There is an IRC channel, `#syncthing` on [Freenode][4], for talking directly
|
2015-04-10 04:20:50 -07:00
|
|
|
to developers and users.
|
2014-11-24 15:04:12 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
## Building
|
2014-08-19 06:33:20 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
Building Syncthing from source is easy, and there's a [guide][5].
|
2015-04-10 04:20:50 -07:00
|
|
|
that describes it for both Unix and Windows systems.
|
2014-04-30 07:13:29 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
## Signed Releases
|
2014-03-20 23:40:48 -07:00
|
|
|
|
2015-01-06 15:06:16 -07:00
|
|
|
As of v0.10.15 and onwards, git tags and release binaries are GPG signed
|
2015-04-10 04:20:50 -07:00
|
|
|
with the key D26E6ED000654A3E (see https://syncthing.net/security.html).
|
2015-01-06 15:06:16 -07:00
|
|
|
For release binaries, MD5 and SHA1 checksums are calculated and signed,
|
|
|
|
available in the md5sum.txt.asc and sha1sum.txt.asc files.
|
2014-03-20 23:40:48 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
## Documentation
|
2013-12-15 03:43:31 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
Please see the [Syncthing documentation site][6].
|
2014-01-06 13:17:18 -07:00
|
|
|
|
2015-09-10 12:42:07 -07:00
|
|
|
All code is licensed under the [MPLv2 License][7].
|
|
|
|
|
2015-10-20 04:41:24 -07:00
|
|
|
[1]: http://docs.syncthing.net/specs/bep-v1.html
|
2015-09-10 12:42:07 -07:00
|
|
|
[2]: http://docs.syncthing.net/intro/getting-started.html
|
|
|
|
[3]: https://github.com/syncthing/syncthing/blob/master/etc
|
|
|
|
[4]: https://webchat.freenode.net/
|
|
|
|
[5]: http://docs.syncthing.net/dev/building.html
|
|
|
|
[6]: http://docs.syncthing.net/
|
|
|
|
[7]: https://github.com/syncthing/syncthing/blob/master/LICENSE
|