django-rustfs¶

The Django storage backend for RustFS.

S3-compatible object storage, without the AWS baggage.

Install in one line¶

pip install django-rustfs

Why django-rustfs?¶

You can use RustFS with django-storages + boto3 — but that means 10+ AWS_* settings for something that isn't AWS.

django-rustfs gives you a purpose-built backend with clean RUSTFS_* settings, built-in health checks, and bucket management out of the box.

Clean Configuration¶

Four settings and you're done — no AWS_S3_ENDPOINT_URL gymnastics.

Bucket Management¶

Create and configure buckets with a single management command.

Health Checks¶

Verify connectivity, auth, and data roundtrips in one command.

Static Files¶

RustFSStaticStorage included — no custom subclass needed.

Quick comparison¶

Feature	django-storages + boto3	django-rustfs
Configuration	10+ AWS-branded settings	*4 clean `RUSTFS_` settings**
Bucket setup	Manual CLI / console	`rustfs_init_buckets`
Health checks	None	`rustfs_health`
Static files	Custom subclass required	`RustFSStaticStorage` included
Dependencies	`django-storages` + `boto3`	`boto3` only

Quick start¶

1. Install2. Configure3. Initialize

pip install django-rustfs

# settings.py
INSTALLED_APPS = [
    # ...
    "django_rustfs",
]

RUSTFS_ENDPOINT = "http://localhost:9000"
RUSTFS_ACCESS_KEY = "your-access-key"
RUSTFS_SECRET_KEY = "your-secret-key"

STORAGES = {
    "default": {
        "BACKEND": "django_rustfs.storage.RustFSStorage",
    },
    "staticfiles": {
        "BACKEND": "django_rustfs.storage.RustFSStaticStorage",
    },
}

python manage.py rustfs_init_buckets
python manage.py rustfs_health

Requirements¶

Dependency	Version
Python	3.9+
Django	4.2 – 6.1
boto3	1.28+

GitHub

PyPI

Issue Tracker