S3 file backend

To use this backend, the store must have its provider_account set to point to an asset storing details of an AWS account.

  • Configuration:

    • bucket_name: (string): The name of the S3 bucket to use.

    • storage_class (string, optional): The storage class to use for newly-uploaded objects.

  • Supports returning local paths: no

  • Supports returning URLs: yes (returns short-lived presigned URLs)

This backend also works with Hetzner Object Storage: in the account configuration, leave region_name unset and set s3_endpoint_url to https://<location code>.your-objectstorage.com/ (e.g. https://hel1.your-objectstorage.com/ for buckets stored in Helsinki). At the time of writing, there may be upload problems if running on Debian trixie due to lack of support for data integrity protection for uploads; if you encounter this, you can try setting AWS_REQUEST_CHECKSUM_CALCULATION=when_required in the environment, or downgrading the python3-boto3 and python3-botocore packages to versions earlier than 1.36.0.