borg-key-import(1)

borg-key-import1

Import the repository key from backup

Usage

borg [common options] key import [options] [REPOSITORY] [PATH]

Overview

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 provided.

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 the 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.

Options

See borg-common(1) for common options of Borg commands.

arguments

REPOSITORY

PATH

path to the backup ('-' to read from stdin)

options

--paper

interactively import from a backup done with --paper

Examples

This command can be used to create a related repository:

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

Author

The Borg Collective

From borg 1.4.5-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.