2017-09-30 20:01:19 +00:00
|
|
|
|
..
|
|
|
|
|
Normally, there are no heading levels assigned to certain characters as the structure is
|
|
|
|
|
determined from the succession of headings. However, this convention is used in Python’s
|
|
|
|
|
Style Guide for documenting which you may follow:
|
|
|
|
|
|
|
|
|
|
# with overline, for parts
|
|
|
|
|
* for chapters
|
|
|
|
|
= for sections
|
|
|
|
|
- for subsections
|
|
|
|
|
^ for subsubsections
|
|
|
|
|
" for paragraphs
|
|
|
|
|
|
|
|
|
|
############
|
|
|
|
|
Installation
|
|
|
|
|
############
|
|
|
|
|
|
|
|
|
|
Packages
|
|
|
|
|
********
|
|
|
|
|
|
2018-03-15 18:07:51 +00:00
|
|
|
|
Note that if at any point the package you’re trying to use is outdated, you
|
|
|
|
|
always have the option to use an official binary from the restic project.
|
|
|
|
|
|
|
|
|
|
These are up to date binaries, built in a reproducible and verifiable way, that
|
|
|
|
|
you can download and run without having to do additional installation work.
|
|
|
|
|
|
|
|
|
|
Please see the :ref:`official_binaries` section below for various downloads.
|
2018-09-04 12:33:26 +00:00
|
|
|
|
Official binaries can be updated in place by using the ``restic self-update``
|
2018-08-12 21:32:01 +00:00
|
|
|
|
command.
|
2018-03-15 18:07:51 +00:00
|
|
|
|
|
2017-09-30 20:01:19 +00:00
|
|
|
|
Arch Linux
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
On `Arch Linux <https://www.archlinux.org/>`__, there is a package called ``restic-git``
|
|
|
|
|
which can be installed from AUR, e.g. with ``pacaur``:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ pacaur -S restic-git
|
|
|
|
|
|
2018-09-04 12:33:26 +00:00
|
|
|
|
Debian
|
|
|
|
|
======
|
|
|
|
|
|
|
|
|
|
On Debian, there's a package called ``restic`` which can be
|
|
|
|
|
installed from the official repos, e.g. with ``apt-get``:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ apt-get install restic
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. warning:: Please be aware that, at the time of writing, Debian *stable*
|
|
|
|
|
has ``restic`` version 0.3.3 which is very old. The *testing* and *unstable*
|
|
|
|
|
branches have recent versions of ``restic``.
|
|
|
|
|
|
|
|
|
|
Fedora
|
|
|
|
|
======
|
|
|
|
|
|
|
|
|
|
restic can be installed using ``dnf``:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ dnf install restic
|
|
|
|
|
|
|
|
|
|
If you used restic from copr previously, remove the copr repo as follows to
|
|
|
|
|
avoid any conflicts:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ dnf copr remove copart/restic
|
|
|
|
|
|
2018-09-05 18:41:37 +00:00
|
|
|
|
macOS
|
|
|
|
|
=====
|
2018-09-04 12:33:26 +00:00
|
|
|
|
|
|
|
|
|
If you are using Mac OS X, you can install restic using the
|
|
|
|
|
`homebrew <http://brew.sh/>`__ package manager:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ brew install restic
|
|
|
|
|
|
2017-09-30 20:01:19 +00:00
|
|
|
|
Nix & NixOS
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
If you are using `Nix <https://nixos.org/nix/>`__ or `NixOS <https://nixos.org/>`__
|
|
|
|
|
there is a package available named ``restic``.
|
2018-09-04 12:33:26 +00:00
|
|
|
|
It can be installed using ``nix-env``:
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
2018-09-04 12:33:26 +00:00
|
|
|
|
$ nix-env --install restic
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-09-04 12:33:26 +00:00
|
|
|
|
OpenBSD
|
|
|
|
|
=======
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-09-04 12:33:26 +00:00
|
|
|
|
On OpenBSD 6.3 and greater, you can install restic using ``pkg_add``:
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
2018-09-04 12:33:26 +00:00
|
|
|
|
# pkg_add restic
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-09-05 18:40:28 +00:00
|
|
|
|
FreeBSD
|
|
|
|
|
=======
|
|
|
|
|
|
|
|
|
|
On FreeBSD (11 and probably later versions), you can install restic using ``pkg install``:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
# pkg install restic
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-03-04 20:50:30 +00:00
|
|
|
|
RHEL & CentOS
|
|
|
|
|
=============
|
|
|
|
|
|
2018-06-09 21:41:35 +00:00
|
|
|
|
restic can be installed via copr repository, for RHEL7/CentOS you can try the following:
|
2018-03-04 20:50:30 +00:00
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ yum install yum-plugin-copr
|
|
|
|
|
$ yum copr enable copart/restic
|
|
|
|
|
$ yum install restic
|
|
|
|
|
|
2018-06-09 21:41:35 +00:00
|
|
|
|
If that doesn't work, you can try adding the repository directly, for CentOS6 use:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ yum-config-manager --add-repo https://copr.fedorainfracloud.org/coprs/copart/restic/repo/epel-6/copart-restic-epel-6.repo
|
|
|
|
|
|
|
|
|
|
For CentOS7 use:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ yum-config-manager --add-repo https://copr.fedorainfracloud.org/coprs/copart/restic/repo/epel-7/copart-restic-epel-7.repo
|
|
|
|
|
|
2018-03-30 21:36:29 +00:00
|
|
|
|
Solus
|
|
|
|
|
=====
|
|
|
|
|
|
|
|
|
|
restic can be installed from the official repo of Solus via the ``eopkg`` package manager:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ eopkg install restic
|
2018-03-15 18:07:51 +00:00
|
|
|
|
|
2018-09-05 18:40:28 +00:00
|
|
|
|
|
|
|
|
|
.. _official_binaries:
|
|
|
|
|
|
2018-03-15 18:07:51 +00:00
|
|
|
|
Official Binaries
|
|
|
|
|
*****************
|
|
|
|
|
|
|
|
|
|
Stable Releases
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
You can download the latest stable release versions of restic from the `restic
|
|
|
|
|
release page <https://github.com/restic/restic/releases/latest>`__. These builds
|
|
|
|
|
are considered stable and releases are made regularly in a controlled manner.
|
|
|
|
|
|
|
|
|
|
There's both pre-compiled binaries for different platforms as well as the source
|
|
|
|
|
code available for download. Just download and run the one matching your system.
|
|
|
|
|
|
2018-08-12 21:32:01 +00:00
|
|
|
|
The official binaries can be updated in place using the ``restic self-update``
|
|
|
|
|
command:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ restic version
|
|
|
|
|
restic 0.9.1 compiled with go1.10.3 on linux/amd64
|
|
|
|
|
|
|
|
|
|
$ restic self-update
|
|
|
|
|
find latest release of restic at GitHub
|
|
|
|
|
latest version is 0.9.2
|
|
|
|
|
download file SHA256SUMS
|
|
|
|
|
download SHA256SUMS
|
|
|
|
|
download file SHA256SUMS
|
|
|
|
|
download SHA256SUMS.asc
|
|
|
|
|
GPG signature verification succeeded
|
|
|
|
|
download restic_0.9.2_linux_amd64.bz2
|
|
|
|
|
downloaded restic_0.9.2_linux_amd64.bz2
|
|
|
|
|
saved 12115904 bytes in ./restic
|
|
|
|
|
successfully updated restic to version 0.9.2
|
|
|
|
|
|
|
|
|
|
$ restic version
|
|
|
|
|
restic 0.9.2 compiled with go1.10.3 on linux/amd64
|
|
|
|
|
|
|
|
|
|
The ``self-update`` command uses the GPG signature on the files uploaded to
|
|
|
|
|
GitHub to verify their authenticity. No external programs are necessary.
|
|
|
|
|
|
|
|
|
|
.. note:: Please be aware that the user executing the ``restic self-update``
|
|
|
|
|
command must have the permission to replace the restic binary.
|
|
|
|
|
If you want to save the downloaded restic binary into a different file, pass
|
|
|
|
|
the file name via the option ``--output``.
|
|
|
|
|
|
2018-03-15 18:07:51 +00:00
|
|
|
|
Unstable Builds
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
Another option is to use the latest builds for the master branch, available on
|
|
|
|
|
the `restic beta download site
|
|
|
|
|
<https://beta.restic.net/?sort=time&order=desc>`__. These too are pre-compiled
|
|
|
|
|
and ready to run, and a new version is built every time a push is made to the
|
|
|
|
|
master branch.
|
|
|
|
|
|
2018-01-19 11:24:09 +00:00
|
|
|
|
Windows
|
|
|
|
|
=======
|
|
|
|
|
|
2018-07-18 01:28:23 +00:00
|
|
|
|
On Windows, put the `restic.exe` binary into `%SystemRoot%\\System32` to use restic
|
2018-01-19 11:24:09 +00:00
|
|
|
|
in scripts without the need for absolute paths to the binary. This requires
|
2018-07-18 01:28:23 +00:00
|
|
|
|
administrator rights.
|
2018-01-19 11:24:09 +00:00
|
|
|
|
|
2017-10-07 14:03:08 +00:00
|
|
|
|
Docker Container
|
|
|
|
|
****************
|
|
|
|
|
|
2018-04-28 14:19:16 +00:00
|
|
|
|
We're maintaining a bare docker container with just a few files and the restic
|
|
|
|
|
binary, you can get it with `docker pull` like this:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ docker pull restic/restic
|
|
|
|
|
|
2017-10-07 14:03:08 +00:00
|
|
|
|
.. note::
|
2018-04-28 14:19:16 +00:00
|
|
|
|
| Another docker container which offers more configuration options is
|
|
|
|
|
| available as a contribution (Thank you!). You can find it at
|
|
|
|
|
| https://github.com/Lobaro/restic-backup-docker
|
2017-10-07 14:03:08 +00:00
|
|
|
|
|
2017-09-30 20:01:19 +00:00
|
|
|
|
From Source
|
|
|
|
|
***********
|
|
|
|
|
|
|
|
|
|
restic is written in the Go programming language and you need at least
|
2018-05-07 21:28:48 +00:00
|
|
|
|
Go version 1.9. Building restic may also work with older versions of Go,
|
2017-09-30 20:01:19 +00:00
|
|
|
|
but that's not supported. See the `Getting
|
|
|
|
|
started <https://golang.org/doc/install>`__ guide of the Go project for
|
|
|
|
|
instructions how to install Go.
|
|
|
|
|
|
|
|
|
|
In order to build restic from source, execute the following steps:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
|
|
|
|
$ git clone https://github.com/restic/restic
|
|
|
|
|
[...]
|
|
|
|
|
|
|
|
|
|
$ cd restic
|
|
|
|
|
|
2018-08-30 20:49:39 +00:00
|
|
|
|
$ go run -mod=vendor build.go
|
|
|
|
|
|
|
|
|
|
For Go versions < 1.11, the option ``-mod=vendor`` needs to be removed, like
|
|
|
|
|
this:
|
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
2017-09-30 20:01:19 +00:00
|
|
|
|
$ go run build.go
|
|
|
|
|
|
|
|
|
|
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):
|
|
|
|
|
|
2018-04-28 14:19:16 +00:00
|
|
|
|
.. code-block:: console
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-08-30 20:49:39 +00:00
|
|
|
|
$ go run -mod=vendor build.go --goos windows --goarch amd64
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-08-30 20:49:39 +00:00
|
|
|
|
$ go run -mod=vendor build.go --goos freebsd --goarch 386
|
|
|
|
|
|
|
|
|
|
$ go run -mod=vendor build.go --goos linux --goarch arm --goarm 6
|
|
|
|
|
|
|
|
|
|
Again, for Go < 1.11 ``-mod=vendor`` needs to be removed.
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
The resulting binary is statically linked and does not require any
|
|
|
|
|
libraries.
|
|
|
|
|
|
|
|
|
|
At the moment, the only tested compiler for restic is the official Go
|
|
|
|
|
compiler. Building restic with gccgo may work, but is not supported.
|
|
|
|
|
|
|
|
|
|
Autocompletion
|
|
|
|
|
**************
|
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
Restic can write out man pages and bash/zsh compatible autocompletion scripts:
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
$ ./restic generate --help
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
The "generate" command writes automatically generated files like the man pages
|
|
|
|
|
and the auto-completion files for bash and zsh).
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
Usage:
|
2018-04-12 15:50:26 +00:00
|
|
|
|
restic generate [command] [flags]
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
|
|
|
|
Flags:
|
2018-04-12 15:50:26 +00:00
|
|
|
|
--bash-completion file write bash completion file
|
|
|
|
|
-h, --help help for generate
|
|
|
|
|
--man directory write man pages to directory
|
|
|
|
|
--zsh-completion file write zsh completion file
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
Example for using sudo to write a bash completion script directly to the system-wide location:
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
.. code-block:: console
|
2017-09-30 20:01:19 +00:00
|
|
|
|
|
2018-04-12 15:50:26 +00:00
|
|
|
|
$ sudo ./restic generate --bash-completion /etc/bash_completion.d/restic
|
|
|
|
|
writing bash completion file to /etc/bash_completion.d/restic
|