borgbackup/docs/usage/repo-create.rst

28 lines
1 KiB
ReStructuredText

.. _borg_repo_create:
.. include:: repo-create.rst.inc
Examples
~~~~~~~~
::
# Local repository
$ export BORG_REPO=/path/to/repo
# Recommended repokey AEAD cryptographic modes
$ borg repo-create --encryption=repokey-aes-ocb
$ borg repo-create --encryption=repokey-chacha20-poly1305
$ borg repo-create --encryption=repokey-blake2-aes-ocb
$ borg repo-create --encryption=repokey-blake2-chacha20-poly1305
# No encryption (not recommended)
$ borg repo-create --encryption=authenticated
$ borg repo-create --encryption=authenticated-blake2
$ borg repo-create --encryption=none
# Remote repository (accesses a remote Borg via SSH)
$ export BORG_REPO=ssh://user@hostname/~/backup
# repokey: stores the encrypted key in <REPO_DIR>/config
$ borg repo-create --encryption=repokey-aes-ocb
# keyfile: stores the encrypted key in the config dir's keys/ subdir
# (e.g. ~/.config/borg/keys/ on Linux, ~/Library/Application Support/borg/keys/ on macOS)
$ borg repo-create --encryption=keyfile-aes-ocb