diff --git a/doc/conf.py b/doc/conf.py index 577b2da00..3f7c66158 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -19,7 +19,7 @@ import os # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. -extensions = [] +extensions = ['sphinx.ext.extlinks'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -104,3 +104,7 @@ html_static_path = ['_static'] # Output file base name for HTML help builder. htmlhelp_basename = 'resticdoc' + +extlinks = { + 'issue': ('https://github.com/restic/restic/issues/%s', '#'), +} diff --git a/doc/faq.rst b/doc/faq.rst index 185bfd978..4bf2f477f 100644 --- a/doc/faq.rst +++ b/doc/faq.rst @@ -26,3 +26,23 @@ The message means that there is more data stored in the repo than strictly necessary. With high probability this is duplicate data. In order to clean it up, the command ``restic prune`` can be used. The cause of this bug is not yet known. + +How can I specify encryption passwords automatically? +----------------------------------------------------- + +When you run ``restict create``, you need to enter the passphrase on +the console. This is not very convenient for automated backups, so you +can also provide the password through the ``--password-file`` option +or ``RESTIC_PASSWORD`` environment. A discussion is in progress over +implementing unattended backups happens in :issue:`533`. + +.. important:: Be careful how you set the environment; using the env + command, a `system()` call or using inline shell + scripts (e.g. `RESTIC_PASSWORD=password borg ...`) + might expose the credentials in the process list + directly and they will be readable to all users on a + system. Using export in a shell script file should be + safe, however, as the environment of a process is + `accessible only to that user`_. + +.. _accessible only to that user: https://security.stackexchange.com/questions/14000/environment-variable-accessibility-in-linux/14009#14009