mirror of https://github.com/borgbackup/borg.git
50 lines
2.0 KiB
HTML
50 lines
2.0 KiB
HTML
.. _borg_migrate-to-repokey:
|
|
|
|
borg migrate-to-repokey
|
|
-----------------------
|
|
::
|
|
|
|
usage: borg migrate-to-repokey [-h] [-v] [--debug] [--lock-wait N]
|
|
[--show-version] [--show-rc] [--no-files-cache]
|
|
[--umask M] [--remote-path PATH]
|
|
[REPOSITORY]
|
|
|
|
Migrate passphrase -> repokey
|
|
|
|
positional arguments:
|
|
REPOSITORY
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
-v, --verbose, --info
|
|
enable informative (verbose) output, work on log level
|
|
INFO
|
|
--debug enable debug output, work on log level DEBUG
|
|
--lock-wait N wait for the lock, but max. N seconds (default: 1).
|
|
--show-version show/log the borg version
|
|
--show-rc show/log the return code (rc)
|
|
--no-files-cache do not load/update the file metadata cache used to
|
|
detect unchanged files
|
|
--umask M set umask to M (local and remote, default: 0077)
|
|
--remote-path PATH set remote path to executable (default: "borg")
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
This command migrates a repository from passphrase mode (not supported any
|
|
more) to repokey mode.
|
|
|
|
You will be first asked for the repository passphrase (to open it in passphrase
|
|
mode). This is the same passphrase as you used to use for this repo before 1.0.
|
|
|
|
It will then derive the different secrets from this passphrase.
|
|
|
|
Then you will be asked for a new passphrase (twice, for safety). This
|
|
passphrase will be used to protect the repokey (which contains these same
|
|
secrets in encrypted form). You may use the same passphrase as you used to
|
|
use, but you may also use a different one.
|
|
|
|
After migrating to repokey mode, you can change the passphrase at any time.
|
|
But please note: the secrets will always stay the same and they could always
|
|
be derived from your (old) passphrase-mode passphrase.
|