Skip to main content
Help us improve Python packaging – donate today!

Django Amazon S3 file storage.

Project Description

django-s3-storage provides a Django Amazon S3 file storage.

Features

  • Django file storage for Amazon S3.
  • Django static file storage for Amazon S3.
  • Works in Python 3!

Installation

  1. Install using pip install django-s3-storage.
  2. Add 'django_s3_storage' to your INSTALLED_APPS setting.
  3. Set your DEFAULT_FILE_STORAGE setting to "django_s3_storage.storage.S3Storage".
  4. Set your STATICFILES_STORAGE setting to "django_s3_storage.storage.StaticS3Storage" or "django_s3_storage.storage.ManifestStaticS3Storage".
  5. Configure your Amazon S3 settings (see Available settings, below).

Available settings

# The region to connect to when storing files.
AWS_REGION = "us-east-1"

# The AWS access key used to access the storage buckets.
AWS_ACCESS_KEY_ID = ""

# The AWS secret access key used to access the storage buckets.
AWS_SECRET_ACCESS_KEY = ""

# The S3 bucket used to store uploaded files.
AWS_S3_BUCKET_NAME = ""

# The S3 bucket name used to store static files.
AWS_S3_BUCKET_NAME_STATIC = ""

How it works

Uploaded user files are stored on Amazon S3 using the private access control level. When a URL for the file is generate, querystring auth with a timeout of 1 hour is used to secure access to the file.

Static files are stored on Amazon S3 using the public access control level and aggressive caching.

Text-based files, such as HTML, XML and JSON, are stored using gzip to save space and improve download performance.

At the moment, files stored on S3 can only be opened in read-only mode.

Support and announcements

Downloads and bug tracking can be found at the main project website.

More information

The django-s3-storage project was developed by Dave Hall. You can get the code from the django-s3-storage project site.

Dave Hall is a freelance web developer, based in Cambridge, UK. You can usually find him on the Internet in a number of different places:

Release history Release notifications

History Node

0.12.4

History Node

0.12.3

History Node

0.12.2

History Node

0.12.1

History Node

0.12.0

History Node

0.11.3

History Node

0.11.2

History Node

0.11.1

History Node

0.11.0

History Node

0.10.0

History Node

0.9.11

History Node

0.9.10

History Node

0.9.9

History Node

0.9.8

History Node

0.9.7

History Node

0.9.6

History Node

0.9.5

History Node

0.9.4

History Node

0.9.3

History Node

0.9.2

History Node

0.9.1

This version
History Node

0.9.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-s3-storage-0.9.0.tar.gz (8.7 kB) Copy SHA256 hash SHA256 Source None Jan 15, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page