# django-storages

> Support for many storage backends in Django

- **URL**: https://www.freshcrate.ai/projects/django-storages
- **Author**: pypi
- **Category**: Databases
- **Latest version**: `1.14.6` (2026-04-21)
- **License**: BSD-3-Clause
- **Source**: https://github.com/jschneier/django-storages
- **Homepage**: https://pypi.org/project/django-storages/
- **Language**: Python
- **GitHub**: 2,949 stars, 887 forks
- **Registry**: pypi (`django-storages`)
- **Tags**: `pypi`

## Description

.. image:: https://raw.githubusercontent.com/jschneier/django-storages/master/docs/logos/horizontal.png
    :alt: Django-Storages
    :width: 100%

.. image:: https://img.shields.io/pypi/v/django-storages.svg
    :target: https://pypi.org/project/django-storages/
    :alt: PyPI Version

.. image:: https://github.com/jschneier/django-storages/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/jschneier/django-storages/actions/workflows/ci.yml
    :alt: Build Status

Installation
============
Installing from PyPI is as easy as doing:

.. code-block:: bash

  pip install django-storages

If you'd prefer to install from source (maybe there is a bugfix in master that
hasn't been released yet) then the magic incantation you are looking for is:

.. code-block:: bash

  pip install -e 'git+https://github.com/jschneier/django-storages.git#egg=django-storages'

For detailed instructions on how to configure the backend of your choice please consult the documentation.

About
=====
django-storages is a project to provide a variety of storage backends in a single library.

This library is usually compatible with the currently supported versions of
Django. Check the Trove classifiers in setup.py to be sure.

django-storages is backed in part by `Tidelift`_. Check them out for all of your enterprise open source
software commercial support needs.

.. _Tidelift: https://tidelift.com/subscription/pkg/pypi-django-storages?utm_source=pypi-django-storages&utm_medium=referral&utm_campaign=enterprise&utm_term=repo

Security
========

To report a security vulnerability, please use the `Tidelift security contact`_. Tidelift will coordinate the
fix and disclosure. Please **do not** post a public issue on the tracker.

.. _Tidelift security contact: https://tidelift.com/security


Found a Bug?
============

Issues are tracked via GitHub issues at the `project issue page
<https://github.com/jschneier/django-storages/issues>`_.

Documentation
=============
Documentation for django-storages is located at https://django-storages.readthedocs.io/.

Contributing
============

#. `Check for open issues
   <https://github.com/jschneier/django-storages/issues>`_ at the project
   issue page or open a new issue to start a discussion about a feature or bug.
#. Fork the `django-storages repository on GitHub
   <https://github.com/jschneier/django-storages>`_ to start making changes.
#. Add a test case to show that the bug is fixed or the feature is implemented
   correctly.
#. Bug me until I can merge your pull request.

Please don't update the library version in CHANGELOG.rst or ``storages/__init__.py``, the maintainer will do that on release.

History
=======
This repo began as a fork of the original library under the package name of django-storages-redux and
became the official successor (releasing under django-storages on PyPI) in February of 2016.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `1.14.6` | 2026-04-21 | Low | Imported from PyPI (1.14.6) |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |
| `master@2025-06-18` | 2025-06-18 | Low | Latest activity on master branch |

## Citation

- HTML: https://www.freshcrate.ai/projects/django-storages
- Markdown: https://www.freshcrate.ai/projects/django-storages.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/django-storages/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._