TrueCloudLab/restic
16
0
Fork 2
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions 1

Merge pull request #3888 from restic/doc-prepare-repo

Browse source 
doc: Improve/clarify preparing and versions of repositories
This commit is contained in:
MichaelEischer 2022-08-24 20:40:49 +02:00 committed by GitHub
commit d198a77d86
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
doc/030_preparing_a_new_repo.rst
View file

@ -14,18 +14,26 @@
Preparing a new repository Preparing a new repository
########################## ##########################
The place where your backups will be saved is called a "repository". The place where your backups will be saved is called a "repository". This is
simply a directory containing a set of subdirectories and files created by
restic to store your backups, some corresponding metadata and encryption keys.
To access the repository, a password (also called a key) must be specified. A
repository can hold multiple keys that can all be used to access the repository.
This chapter explains how to create ("init") such a repository. The repository This chapter explains how to create ("init") such a repository. The repository
can be stored locally, or on some remote server or service. We'll first cover can be stored locally, or on some remote server or service. We'll first cover
using a local repository; the remaining sections of this chapter cover all the using a local repository; the remaining sections of this chapter cover all the
other options. You can skip to the next chapter once you've read the relevant other options. You can skip to the next chapter once you've read the relevant
section here. section here.
For automated backups, restic accepts the repository location in the For automated backups, restic supports specifying the repository location in the
environment variable ``RESTIC_REPOSITORY``. Restic can also read the repository environment variable ``RESTIC_REPOSITORY``. Restic can also read the repository
location from a file specified via the ``--repository-file`` option or the location from a file specified via the ``--repository-file`` option or the
environment variable ``RESTIC_REPOSITORY_FILE``. For the password, several environment variable ``RESTIC_REPOSITORY_FILE``.
options exist:
For automating the supply of the repository password to restic, several options
exist:
* Setting the environment variable ``RESTIC_PASSWORD`` * Setting the environment variable ``RESTIC_PASSWORD``
@ -36,21 +44,24 @@ options exist:
option ``--password-command`` or the environment variable option ``--password-command`` or the environment variable
``RESTIC_PASSWORD_COMMAND`` ``RESTIC_PASSWORD_COMMAND``
* The ``init`` command has an option called ``--repository-version`` which can The ``init`` command has an option called ``--repository-version`` which can
be used to explicitely set the version for the new repository. By default, be used to explicitly set the version of the new repository. By default, the
the current stable version is used. Have a look at the `design documentation current stable version is used (see table below). The alias ``latest`` will
<https://github.com/restic/restic/blob/master/doc/design.rst>`__ for always resolve to the latest repository version. Have a look at the `design
details. The alias ``latest`` will always point to the latest repository version. documentation <https://github.com/restic/restic/blob/master/doc/design.rst>`__
The below table shows which restic version is required to use a certain for more details.
repository version and shows new features introduced by the repository format.
+--------------------+------------------------+---------------------+ The below table shows which restic version is required to use a certain
| Repository version | Minimum restic version | Major new features | repository version, as well as notable features introduced in the various
+====================+========================+=====================+ versions.
| ``1`` | any version | |
+--------------------+------------------------+---------------------+ +--------------------+-------------------------+---------------------+------------------+
| ``2`` | >= 0.14.0 | Compression support | | Repository version | Required restic version | Major new features | Comment |
+--------------------+------------------------+---------------------+ +====================+=========================+=====================+==================+
| ``1`` | Any | | Current default |
+--------------------+-------------------------+---------------------+------------------+
| ``2`` | 0.14.0 or newer | Compression support | |
+--------------------+-------------------------+---------------------+------------------+
Local Local