syncthing/README.md

60 lines
2.4 KiB
Markdown
Raw Normal View History

2015-05-31 09:35:17 +02:00
Syncthing
2013-12-15 11:43:31 +01: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 15:18:50 +02:00
[![AppVeyor Build](https://img.shields.io/appveyor/ci/calmh/syncthing/master.svg?style=flat-square)](https://ci.appveyor.com/project/calmh/syncthing)
[![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 12:56:05 +02:00
2015-05-31 09:35:17 +02:00
This is the Syncthing project which pursues the following goals:
2013-12-15 11:43:31 +01:00
2014-09-28 13:39:39 +02:00
1. Define a protocol for synchronization of a folder between a number of
2015-04-10 13:20:50 +02:00
collaborating devices. This protocol should be well defined, unambiguous,
2014-09-28 13:39:39 +02:00
easily understood, free to use, efficient, secure and language neutral.
2015-04-10 13:20:50 +02:00
This is called the [Block Exchange
2015-01-09 08:54:19 +01:00
Protocol](https://github.com/syncthing/specs/blob/master/BEPv1.md).
2013-12-15 11:43:31 +01:00
2. Provide the reference implementation to demonstrate the usability of
2015-04-10 13:20:50 +02:00
said protocol. This is the `syncthing` utility. We hope that
2015-04-28 17:34:55 +02:00
alternative, compatible implementations of the protocol will arise.
2013-12-15 11:43:31 +01:00
The two are evolving together; the protocol is not to be considered
2015-05-31 09:35:17 +02:00
stable until Syncthing 1.0 is released, at which point it is locked down
2013-12-15 11:43:31 +01:00
for incompatible changes.
2014-04-30 16:13:29 +02:00
Getting Started
---------------
2015-01-03 16:44:13 +01:00
Take a look at the [getting started
2015-05-31 09:35:17 +02:00
guide](http://docs.syncthing.net/intro/getting-started.html).
2014-08-19 15:33:20 +02:00
2015-05-31 09:35:17 +02:00
There are a few examples for keeping Syncthing running in the background
2014-11-24 13:47:56 +01:00
on your system in [the etc directory](https://github.com/syncthing/syncthing/blob/master/etc).
2014-11-24 23:04:12 +01:00
There is an IRC channel, `#syncthing` on Freenode, for talking directly
2015-04-10 13:20:50 +02:00
to developers and users.
2014-11-24 23:04:12 +01:00
2014-08-19 15:33:20 +02:00
Building
--------
Building Syncthing from source is easy, and there's a
2015-05-31 09:35:17 +02:00
[guide](http://docs.syncthing.net/dev/building.html).
2015-04-10 13:20:50 +02:00
that describes it for both Unix and Windows systems.
2014-04-30 16:13:29 +02:00
Signed Releases
---------------
As of v0.10.15 and onwards, git tags and release binaries are GPG signed
2015-04-10 13:20:50 +02:00
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
=============
2013-12-15 11:43:31 +01:00
2015-05-31 09:35:17 +02:00
Please see the [Syncthing
2015-06-11 12:54:41 +02:00
documentation site](http://docs.syncthing.net/).
2014-09-29 21:43:32 +02:00
All code is licensed under the
2015-04-10 13:20:50 +02:00
[MPLv2 License](https://github.com/syncthing/syncthing/blob/master/LICENSE).