From c586a5e20fb9b5b227fbc0709bf77021190508ab Mon Sep 17 00:00:00 2001 From: Michael Eischer Date: Sun, 21 Aug 2022 11:39:03 +0200 Subject: [PATCH] doc: recommend usage of B2's S3 API --- doc/030_preparing_a_new_repo.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/030_preparing_a_new_repo.rst b/doc/030_preparing_a_new_repo.rst index c8ad425a3..f3c37e3ef 100644 --- a/doc/030_preparing_a_new_repo.rst +++ b/doc/030_preparing_a_new_repo.rst @@ -450,6 +450,16 @@ The policy of the new container created by restic can be changed using environme Backblaze B2 ************ +.. warning:: + + The recommended way to setup Backblaze B2 is by using its S3-compatible API. + Follow the documentation to `generate S3-compatible access keys`_ and then + setup restic as described at :ref:`Amazon S3`. + + Different from the B2 backend, restic's S3 backend will only hide no longer + necessary files. Thus, make sure to setup lifecycle rules to eventually + delete hidden files. + Restic can backup data to any Backblaze B2 bucket. You need to first setup the following environment variables with the credentials you can find in the dashboard on the "Buckets" page when signed into your B2 account: @@ -488,6 +498,8 @@ The number of concurrent connections to the B2 service can be set with the ``-o b2.connections=10`` switch. By default, at most five parallel connections are established. +.. _generate S3-compatible access keys: https://help.backblaze.com/hc/en-us/articles/360047425453-Getting-Started-with-the-S3-Compatible-API + Microsoft Azure Blob Storage ****************************