Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!


Project Description

This is a utility for Django that implements the Django Storage API (for storing FileFields, ImageFields, etc.) and stores the contents of the files in your Django database instead of on the filesystem.

This is mainly intended to be an easy-to-use way to store file attachments and get rid of the pain of managing filesystem access at run time, and the deployment issues that come with it. If your file attachment needs are simple, this will generally be a quick way to get your app working.


  • Store any file in any database supported by Django.
  • Simplify deployment and data management: No need to keep track of file attachments when migrating data from one server to another, since files live in the database.


  • Django does not support binary fields (issue #2417) and as of this writing, expects queries to always return unicode data (issue #5135). As a result, this library uses base64 encoding to make binary data safe for the database, which inflates data size by about 33%.
  • Databases are not always built with large file storage in mind (unlike filesystems). As such, this is based on the assumption that files are “reasonably” sized, meaning well under 1MB. Files are entirely loaded into RAM during requests. Your mileage may vary.
  • No performance guarantees whatsoever. The idea is that these are small image attachments for a blog or similar, not that you are hosting a Youtube clone in your Django database.

Getting Started

  1. Install (pip install django-database-storage)

  2. Read the help:

    $ ./ shell … >>> from database_storage import DatabaseStorage >>> help(DatabaseStorage)

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-database-storage-0.1.2.tar.gz (5.1 kB) Copy SHA256 Checksum SHA256 Source May 24, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting