summaryrefslogtreecommitdiffstats
path: root/docs/usage/key_import.rst.inc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/usage/key_import.rst.inc')
-rw-r--r--docs/usage/key_import.rst.inc11
1 files changed, 10 insertions, 1 deletions
diff --git a/docs/usage/key_import.rst.inc b/docs/usage/key_import.rst.inc
index ab997d44c..a0890ff38 100644
--- a/docs/usage/key_import.rst.inc
+++ b/docs/usage/key_import.rst.inc
@@ -58,4 +58,13 @@ This command restores a key previously backed up with the export command.
If the ``--paper`` option is given, the import will be an interactive
process in which each line is checked for plausibility before
-proceeding to the next line. For this format PATH must not be given. \ No newline at end of file
+proceeding to the next line. For this format PATH must not be given.
+
+For repositories using keyfile encryption, the key file which ``borg key
+import`` writes to depends on several factors. If the ``BORG_KEY_FILE``
+environment variable is set and non-empty, ``borg key import`` creates
+or overwrites that file named by ``$BORG_KEY_FILE``. Otherwise, ``borg
+key import`` searches in the ``$BORG_KEYS_DIR`` directory for a key file
+associated with the repository. If a key file is found in
+``$BORG_KEYS_DIR``, ``borg key import`` overwrites it; otherwise, ``borg
+key import`` creates a new key file in ``$BORG_KEYS_DIR``. \ No newline at end of file