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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_custom_storage-0.3.8.tar.gz (41.9 kB view details)

Uploaded Aug 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

django_custom_storage-0.3.8-py3-none-any.whl (73.0 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

Details for the file django_custom_storage-0.3.8.tar.gz.

File metadata

Download URL: django_custom_storage-0.3.8.tar.gz
Upload date: Aug 12, 2026
Size: 41.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_custom_storage-0.3.8.tar.gz
Algorithm	Hash digest
SHA256	`bd39599567a4f8a359d5b37a15365bc11c70c5a4cf10033cbdfd9132d41f46f1`
MD5	`27f4d1a2566c45a90349376a880e5f6a`
BLAKE2b-256	`dc8738fcd680548066f9b8d99d5f1ab97bfdba24a017c408363a49023f8762e7`

See more details on using hashes here.

File details

Details for the file django_custom_storage-0.3.8-py3-none-any.whl.

File metadata

Download URL: django_custom_storage-0.3.8-py3-none-any.whl
Upload date: Aug 12, 2026
Size: 73.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_custom_storage-0.3.8-py3-none-any.whl
Algorithm	Hash digest
SHA256	`683e1e279870089c7ab66af3437bfb0f80c4de2411177200710a39473f2984eb`
MD5	`3f08824927f0fe3726cc76ed2249f9ee`
BLAKE2b-256	`90e1f1bf4e2108d0a74540ccb2ad12b0a93829a9b60a00dd0d90736a378d7efc`