Registry /
aws / synapse-s3-storage-provider
Install & Compatibility
Where this runs
tested against v? · pip install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
S3StorageProviderBackend
✓ from s3_storage_provider import S3StorageProviderBackend
✗ from s3_storage_provider import S3StorageProviderBackend
Basic configuration example for Synapse's homeserver.yaml. The module is loaded automatically by Synapse; manual instantiation is for testing.
# In Synapse's homeserver.yaml under the `media_store` section:
# media_store:
# storage_providers:
# - module: s3_storage_provider.S3StorageProviderBackend
# store_local: True
# store_remote: True
# store_synchronous: False
# config:
# bucket: my-matrix-media-bucket
# region_name: us-east-1
# # Optional: access_key_id: YOUR_ACCESS_KEY
# # Optional: secret_access_key: YOUR_SECRET_KEY
# # Optional: session_token: YOUR_SESSION_TOKEN
# # Optional: prefix: myprefix/
# # Optional: endpoint_url: https://s3.custom-endpoint.com
import os
from s3_storage_provider import S3StorageProviderBackend
# Example: creating an instance manually (not typical, usually via Synapse config)
backend = S3StorageProviderBackend(
config={
"bucket": "my-bucket",
"region_name": "us-east-1",
"access_key_id": os.environ.get('AWS_ACCESS_KEY_ID', ''),
"secret_access_key": os.environ.get('AWS_SECRET_ACCESS_KEY', ''),
}
)
s3-storage-provider --version
Upgrade
Version history
1.6.1latest on PyPI · released May 13, 2026
Audit
Dependencies
matrix-synapserequiredRequired at runtime; interacts directly with Synapse storage layer.
boto3requiredAWS SDK for Python; required for S3 operations.