django-custom-storage

GitHub

Test

Check Demo Project

Check the demo repo on GitHub

Requirements

Python 3.10+ supported.
Django 4.2+ supported.

Setup

Install from pip:

pip install django-custom-storage

Modify settings.py by adding the app to INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    "compressor",
    "custom_storage",
    # ...
]

Configure storage in settings.py. The package ships sensible defaults and reads the project specifics from APP_CONFIG["custom_storage"]; call apply_storage_defaults at the end of the file so the STORAGES, compression and AWS settings are derived for you:

# Project paths (kept in the project; not owned by the package)
MEDIA_ROOT = "/var/opt/your_project_name/mediaroot/"
STATIC_ROOT = "/var/cache/your_project_name/staticroot/"

# AWS credentials
AWS_ACCESS_KEY_ID = "YOUR_PROJECT_AWS_ACCESS_KEY_ID"
AWS_SECRET_ACCESS_KEY = "YOUR_PROJECT_AWS_SECRET_ACCESS_KEY"

# Project-specific options; everything else falls back to the package defaults.
APP_CONFIG = {
    "custom_storage": {
        "BUCKET_NAME": "your_project_bucket_name",
        "CUSTOM_DOMAIN": "cdn.your_project_bucket_name.com",
        # Optional overrides: FILE_EXPIRE, DEFAULT_ACL, PRIVATE_LOCATION, ...
    },
}

from custom_storage.conf import apply_storage_defaults

apply_storage_defaults(globals())

Top-level Django settings always win, so projects that already declare STORAGES, COMPRESS_* or AWS_* keep working unchanged. To serve assets from the local filesystem (handy in development) start the server with --force-local-storage or set FORCE_LOCAL_STORAGE = True.

See Settings for every available key and Storage classes for the backends, including the private storage that serves non-public uploads through signed, expiring URLs.

Run Example Project

git clone --depth=50 --branch=django-custom-storage https://github.com/DLRSP/example.git DLRSP/example
cd DLRSP/example
python manage.py runserver

Now browser the app @ http://127.0.0.1:8000

Release files for django-custom-storage 0.3.35

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-custom-storage 0.3.35
File	Size	Uploaded
django_custom_storage-0.3.35.tar.gz	42.1 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-custom-storage 0.3.35
File	Interpreter	ABI	Platform	Reset
django_custom_storage-0.3.35-py3-none-any.whl 73.1 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 115.2 kB

Release files / django_custom_storage-0.3.35.tar.gz

Download URL	django_custom_storage-0.3.35.tar.gz
Size	42.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`0f68071b9f8d6ba3d67cbcd7afb0f803e23ade619ee9527a6b0c70350b655e82`
BLAKE2b-256 checksum How to use checksums	`2eae11142bc7cf31b43c8015e1d21ff02c219f1534303b3856ae2f925d2088e0`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / django_custom_storage-0.3.35-py3-none-any.whl

Download URL	django_custom_storage-0.3.35-py3-none-any.whl
Size	73.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`83c3b952a498f9d4f73d2fe6cd889ac55d3e44d983f4cd5663de8ff0e4983bf9`
BLAKE2b-256 checksum How to use checksums	`040e3df4e3ba5e80c4efe2f32d0755987a4c04dcb188d006306f04a1f63328e9`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`