diff --git a/docs/backends/backblaze-B2.rst b/docs/backends/backblaze-B2.rst new file mode 100644 index 000000000..4d30281c6 --- /dev/null +++ b/docs/backends/backblaze-B2.rst @@ -0,0 +1,13 @@ +Backblaze B2 +============ + +Backblaze B2 implements an `S3 Compatible API `_. To use it as a django-storages backend: + +#. Sign up for a `Backblaze B2 account `_, if you have not already done so. +#. Create a public or private bucket. Note that object-level ACLs are not supported by B2 - all objects inherit their bucket's ACLs. +#. Create an `application key `_. Best practice is to limit access to the bucket you just created. +#. Follow the instructions in the :doc:`Amazon S3 docs ` with the following exceptions: + + * Set ``AWS_S3_REGION_NAME`` to your Backblaze B2 region, for example, ``us-west-004`` + * Set ``AWS_S3_ENDPOINT_URL`` to ``https://s3.${AWS_S3_REGION_NAME}.backblazeb2.com`` + * Set the values of ``AWS_ACCESS_KEY_ID`` and ``AWS_SECRET_ACCESS_KEY`` to the application key id and application key you created in step 2.