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.
Official binaries can be updated in place by using the
On Arch Linux, there is a package called
installed from the official community repos, e.g. with
$ pacman -S restic
On Debian, there's a package called
restic which can be
installed from the official repos, e.g. with
$ apt-get install restic
Please be aware that, at the time of writing, Debian stable
restic version 0.3.3 which is very old. The testing and unstable
branches have recent versions of
restic can be installed using
$ dnf install restic
If you used restic from copr previously, remove the copr repo as follows to avoid any conflicts:
$ dnf copr remove copart/restic
If you are using macOS, you can install restic using the homebrew package manager:
$ brew install restic
You may also install it using MacPorts:
$ sudo port install restic
Nix & NixOS
$ nix-env --install restic
On OpenBSD 6.3 and greater, you can install restic using
# pkg_add restic
On FreeBSD (11 and probably later versions), you can install restic using
# pkg install restic
RHEL & CentOS
restic can be installed via copr repository, for RHEL7/CentOS you can try the following:
$ yum install yum-plugin-copr $ yum copr enable copart/restic $ yum install restic
If that doesn't work, you can try adding the repository directly, for CentOS6 use:
$ yum-config-manager --add-repo https://copr.fedorainfracloud.org/coprs/copart/restic/repo/epel-6/copart-restic-epel-6.repo
For CentOS7 use:
$ yum-config-manager --add-repo https://copr.fedorainfracloud.org/coprs/copart/restic/repo/epel-7/copart-restic-epel-7.repo
restic can be installed from the official repo of Solus via the
eopkg package manager:
$ eopkg install restic
restic can be installed using Scoop:
scoop install restic
Using this installation method,
restic.exe will automatically be available
PATH. It can be called from cmd.exe or PowerShell by typing
You can download the latest stable release versions of restic from the restic release page. 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.
The official binaries can be updated in place using the
$ 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
self-update command uses the GPG signature on the files uploaded to
GitHub to verify their authenticity. No external programs are necessary.
Please be aware that the user executing the
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
Another option is to use the latest builds for the master branch, available on the restic beta download site. 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.
On Windows, put the restic.exe binary into %SystemRoot%\System32 to use restic in scripts without the need for absolute paths to the binary. This requires administrator rights.
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:
$ docker pull restic/restic
restic is written in the Go programming language and you need at least Go version 1.9. Building restic may also work with older versions of Go, but that's not supported. See the Getting started guide of the Go project for instructions how to install Go.
In order to build restic from source, execute the following steps:
$ git clone https://github.com/restic/restic [...] $ cd restic $ go run -mod=vendor build.go
For Go versions < 1.11, the option
-mod=vendor needs to be removed, like
$ 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):
$ go run -mod=vendor build.go --goos windows --goarch amd64 $ 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.
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.
Restic can write out man pages and bash/zsh compatible autocompletion scripts:
$ ./restic generate --help The "generate" command writes automatically generated files like the man pages and the auto-completion files for bash and zsh). Usage: restic generate [command] [flags] Flags: --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
Example for using sudo to write a bash completion script directly to the system-wide location:
$ sudo ./restic generate --bash-completion /etc/bash_completion.d/restic writing bash completion file to /etc/bash_completion.d/restic