2016-05-08 10:24:09 +00:00
|
|
|
[](https://restic.readthedocs.io/en/latest/?badge=latest)
|
2015-03-14 12:23:44 +00:00
|
|
|
[](https://travis-ci.org/restic/restic)
|
2015-08-19 20:20:44 +00:00
|
|
|
[](https://ci.appveyor.com/project/fd0/restic/branch/master)
|
2016-07-29 19:35:06 +00:00
|
|
|
[](http://goreportcard.com/report/github.com/restic/restic)
|
2014-11-15 23:43:15 +00:00
|
|
|
|
2014-04-27 13:49:48 +00:00
|
|
|
|
2016-02-21 12:37:55 +00:00
|
|
|
Introduction
|
|
|
|
|
============
|
2014-04-27 13:49:48 +00:00
|
|
|
|
2016-02-21 12:37:55 +00:00
|
|
|
restic is a backup program that is fast, efficient and secure. Detailed
|
|
|
|
|
information can be found in [the documentation](doc/index.md) and [the user
|
|
|
|
|
manual](doc/Manual.md). The [design document](doc/Design.md) lists the
|
|
|
|
|
technical background and gives detailed information about the structure of the
|
2017-01-18 20:48:39 +00:00
|
|
|
repository and the data saved therein. The file [FAQ.md](doc/FAQ.md) lists the
|
|
|
|
|
most frequently asked questions.
|
2014-11-16 11:08:11 +00:00
|
|
|
|
2016-02-21 12:37:55 +00:00
|
|
|
The latest documentation can be viewed online at
|
2016-05-05 11:25:06 +00:00
|
|
|
<https://restic.readthedocs.io/en/latest>. On the bottom left corner there is
|
2016-02-21 12:37:55 +00:00
|
|
|
a menu that allows switching to the documentation and user manual for the
|
|
|
|
|
latest released version.
|
2014-11-16 11:08:11 +00:00
|
|
|
|
2017-02-21 10:12:07 +00:00
|
|
|
News
|
|
|
|
|
====
|
|
|
|
|
|
|
|
|
|
You can follow the restic project on Twitter
|
|
|
|
|
[@resticbackup](https://twitter.com/resticbackup) or by subscribing to the
|
|
|
|
|
[development blog](https://restic.github.io/blog/).
|
|
|
|
|
|
2017-02-03 08:09:49 +00:00
|
|
|
Install restic
|
|
|
|
|
==============
|
2014-10-02 19:42:53 +00:00
|
|
|
|
2017-02-03 08:09:49 +00:00
|
|
|
You can download the latest pre-compiled binary from the [restic release page](https://github.com/restic/restic/releases/latest).
|
2015-05-12 19:22:52 +00:00
|
|
|
|
2017-02-03 09:41:54 +00:00
|
|
|
Build restic
|
|
|
|
|
============
|
|
|
|
|
|
2017-03-08 19:12:16 +00:00
|
|
|
Install Go/Golang (at least version 1.7), then run `go run build.go`,
|
2017-02-03 09:41:54 +00:00
|
|
|
afterwards you'll find the binary in the current directory:
|
2015-05-12 19:36:54 +00:00
|
|
|
|
2017-02-03 09:41:54 +00:00
|
|
|
$ go run build.go
|
|
|
|
|
|
|
|
|
|
$ ./restic --help
|
|
|
|
|
Usage:
|
|
|
|
|
restic [OPTIONS] <command>
|
|
|
|
|
[...]
|
2015-05-12 19:36:54 +00:00
|
|
|
|
2017-03-09 10:37:06 +00:00
|
|
|
You can easily cross-compile restic for all supported platforms, just supply
|
|
|
|
|
the target OS and platform via the command-line options like this (for Windows
|
|
|
|
|
and FreeBSD respectively):
|
|
|
|
|
|
|
|
|
|
$ go run build.go --goos windows --goarch amd64
|
|
|
|
|
|
|
|
|
|
$ go run build.go --goos freebsd --goarch 386
|
|
|
|
|
|
|
|
|
|
The resulting binary is statically linked and does not require any libraries.
|
|
|
|
|
|
2016-02-21 12:37:55 +00:00
|
|
|
More documentation can be found in the [user manual](doc/Manual.md).
|
2015-07-11 23:48:24 +00:00
|
|
|
|
2017-02-03 09:41:54 +00:00
|
|
|
At the moment, the only tested compiler for restic is the official Go compiler.
|
|
|
|
|
Building restic with gccgo may work, but is not supported.
|
|
|
|
|
|
2015-05-06 21:18:46 +00:00
|
|
|
Contribute and Documentation
|
|
|
|
|
============================
|
|
|
|
|
|
2017-02-01 11:00:38 +00:00
|
|
|
Contributions are welcome! Please **open an issue first** (or add a comment to
|
|
|
|
|
an existing issue) if you plan to work on any code or add a new feature. This
|
|
|
|
|
way, duplicate work is prevented and we can discuss your ideas and design
|
|
|
|
|
first.
|
|
|
|
|
|
|
|
|
|
More information and a description of the development environment can be found
|
|
|
|
|
in [`CONTRIBUTING.md`](CONTRIBUTING.md). A document describing the design of
|
|
|
|
|
restic and the data structures stored on the back end is contained in
|
|
|
|
|
[`doc/Design.md`](doc/Design.md).
|
2015-06-24 17:20:27 +00:00
|
|
|
|
2016-03-12 10:28:10 +00:00
|
|
|
If you'd like to start contributing to restic, but don't know exactly what do
|
|
|
|
|
to, have a look at this great article by Dave Cheney:
|
|
|
|
|
[Suggestions for contributing to an Open Source project](http://dave.cheney.net/2016/03/12/suggestions-for-contributing-to-an-open-source-project)
|
|
|
|
|
A few issues have been tagged with the label `help wanted`, you can start
|
|
|
|
|
looking at those: https://github.com/restic/restic/labels/help%20wanted
|
|
|
|
|
|
2015-03-13 20:46:52 +00:00
|
|
|
Contact
|
|
|
|
|
=======
|
|
|
|
|
|
2015-11-22 18:23:48 +00:00
|
|
|
If you discover a bug, find something surprising or if you would like to
|
|
|
|
|
discuss or ask something, please [open a github issue](https://github.com/restic/restic/issues/new).
|
|
|
|
|
If you would like to chat about restic, there is also the IRC channel #restic
|
|
|
|
|
on irc.freenode.net.
|
2015-03-13 20:46:52 +00:00
|
|
|
|
2015-07-07 23:43:09 +00:00
|
|
|
**Important**: If you discover something that you believe to be a possible critical
|
|
|
|
|
security problem, please do *not* open a GitHub issue but send an email directly to
|
2015-10-29 20:51:21 +00:00
|
|
|
alexander@bumpern.de. If possible, please encrypt your email using the following PGP key
|
|
|
|
|
([0x91A6868BD3F7A907](https://pgp.mit.edu/pks/lookup?op=get&search=0xCF8F18F2844575973F79D4E191A6868BD3F7A907)):
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
pub 4096R/91A6868BD3F7A907 2014-11-01
|
|
|
|
|
Key fingerprint = CF8F 18F2 8445 7597 3F79 D4E1 91A6 868B D3F7 A907
|
|
|
|
|
uid Alexander Neumann <alexander@bumpern.de>
|
|
|
|
|
sub 4096R/D5FC2ACF4043FDF1 2014-11-01
|
|
|
|
|
```
|
2015-07-07 23:43:09 +00:00
|
|
|
|
2014-04-27 13:49:48 +00:00
|
|
|
License
|
|
|
|
|
=======
|
|
|
|
|
|
2014-12-05 20:53:26 +00:00
|
|
|
Restic is licensed under "BSD 2-Clause License". You can find the complete text
|
2014-04-27 13:49:48 +00:00
|
|
|
in the file `LICENSE`.
|
