django-private-storage
Private media file storage for Django projects
Decision gist · record as of 2026-08-14
Yes. The package solves a common Django problem (protecting user uploads behind login) with minimal install friction, no runtime dependencies, and a stable API across modern Django versions. The aging maintenance status (313 days since last release) is acceptable for a mature, production-stable feature; no known vulnerabilities. Use it when you need to gate file access by user authentication without building custom storage logic.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Django to be installed and configured; no explicit Python version minimum stated in fact sheet.
- Low friction install with no runtime dependencies.
- Last commit was 313 days ago; the project is in aging maintenance status but remains archived=false and carries a production/stable classifier across Django 2.2 through 5.2.
License · maintenance · safety
permissive license (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most production deployments.
last release 2025-10-05 (313 days) · last repo commit 2025-10-05 · 351 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,202 downloads/mo, #14,861 on PyPI
Alternatives
Verify before relying
pip install django-private-storage
# In settings.py
INSTALLED_APPS += ('private_storage',)
PRIVATE_STORAGE_ROOT = '/path/to/private-media/'
PRIVATE_STORAGE_AUTH_FUNCTION = 'private_storage.permissions.allow_staff'
# In urls.py
import private_storage.urls
urlpatterns += [path('private-media/', include(private_storage.urls))]- Whether the package works with Django versions prior to 2.2 despite classifiers listing 2.2 as earliest
- Performance characteristics when serving large files through the private storage proxy
- Whether S3 and MinIO storage backends require additional package dependencies beyond what is listed
What it is and what it does
django-private-storage adds a custom file storage backend to Django that keeps uploaded files outside the web-accessible directory and gates access through authentication. It provides model fields that work seamlessly with Django's admin and form rendering, automatically enforcing access control based on configurable permission functions. The package supports local filesystem storage by default, with optional backends for Amazon S3 and MinIO object storage; you define which users can download files via a simple auth function, and the package handles serving files through a protected view.
The module integrates directly into Django's storage API, meaning existing form widgets and admin interfaces work without modification. You configure a root directory for private files, add the app to INSTALLED_APPS, include its URL patterns, and then use the provided field types in your models just like a regular FileField. Access control is pluggable—built-in options include allow_authenticated, allow_staff, and allow_superuser, or you can write a custom function that receives the request and file metadata.
Use it for
- Restrict document downloads to logged-in users in a SaaS application
- Store confidential user uploads (contracts, invoices) behind authentication
- Serve images or media only to staff members via the admin interface
- Implement object-level access control by subclassing the provided detail view
- Offload private file storage to S3 or MinIO while maintaining Django model integration
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package solves a common Django problem (protecting user uploads behind login) with minimal install friction, no runtime dependencies, and a stable API across modern Django versions. The aging maintenance status (313 days since last release) is acceptable for a mature, production-stable feature; no known vulnerabilities. Use it when you need to gate file access by user authentication without building custom storage logic.
Install
django-private-storage on PyPI
Before you install
Low friction install with no runtime dependencies. Last commit was 313 days ago; the project is in aging maintenance status but remains archived=false and carries a production/stable classifier across Django 2.2 through 5.2.
Requires Django to be installed and configured; no explicit Python version minimum stated in fact sheet.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most production deployments.
Quickstart
pip install django-private-storage
# In settings.py
INSTALLED_APPS += ('private_storage',)
PRIVATE_STORAGE_ROOT = '/path/to/private-media/'
PRIVATE_STORAGE_AUTH_FUNCTION = 'private_storage.permissions.allow_staff'
# In urls.py
import private_storage.urls
urlpatterns += [path('private-media/', include(private_storage.urls))]Verify before relying
- Whether the package works with Django versions prior to 2.2 despite classifiers listing 2.2 as earliest
- Performance characteristics when serving large files through the private storage proxy
- Whether S3 and MinIO storage backends require additional package dependencies beyond what is listed
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 313 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 74,202 / month, #14,861 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentFramework :: DjangoFramework :: Django :: 2.2Framework :: Django :: 3.0Framework :: Django :: 3.1Framework :: Django :: 3.2Framework :: Django :: 4.0Framework :: Django :: 4.1Framework :: Django :: 4.2Framework :: Django :: 5.0Framework :: Django :: 5.1Framework :: Django :: 5.2Intended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.12Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Internet :: WWW/HTTPTopic :: Internet :: WWW/HTTP :: Dynamic ContentTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python Modules |
Evidence: django_private_storage-3.1.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “django private file storage”
- django-private-storageProvides a Django storage backend that restricts file uploads and…
- django-s3-storageProvides Django file storage backends that read from and write to…
- django-storagesdjango-storages provides pluggable storage backends for Django…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also django-s3-storage · django-dbbackup · django-cryptography · synapse-s3-storage-provider · django-enumfields · django-cryptography-5 · django-constance · django-cloudinary-storage · django-reverse-admin · django-nested-inline