Skip to content

Latest commit

 

History

History
61 lines (38 loc) · 1.45 KB

README.md

File metadata and controls

61 lines (38 loc) · 1.45 KB
Raw

django-bunny-storage

Provides Bunny.net file storage in Django.

Installation

django-bunny-storage requires Python >= 3.7.

pip install django-bunny-storage

Configuration

Everything is configured in your settings.py file.

To use:

  1. Add django_bunny_storage to your INSTALLED_APPS.
INSTALLED_APPS = [
    ...
    'django_bunny_storage'
]
  1. Add BUNNY_USERNAME and BUNNY_PASSWORD to your settings.
BUNNY_USERNAME = 'myzone'

BUNNY_PASSWORD = 'myzone-random-password-string'

# Optional
BUNNY_REGION = 'de'

These settings correspond to your storage zone's Username and Password found under FTP & API Access in your Bunny.net Storage dashboard.

You must include BUNNY_REGION if the default region, NY, does not match the region you set yourself.

  1. Change your media url and default file storage backend.
DEFAULT_FILE_STORAGE = 'django_bunny_storage.storage.BunnyStorage'

MEDIA_URL = 'https://myzone.b-cdn.net/' # The Pull Zone hostname.

The MEDIA_URL is set based on a linked Pull Zone that you setup in the Bunny.net dashboard.

In Templates

In order to display your media properly in templates, refer to Django's docs on the MEDIA_URL attribute to ensure you're not getting 404s when trying to load media.

Whenever referencing media, do

<img src="{{ MEDIA_URL }}{{ mymodel.file }}" />