---
title: "Django With Wasabi"
slug: "how-do-i-use-django-with-wasabi-s3"
updated: 2026-02-09T17:22:14Z
published: 2026-02-09T17:22:14Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Django With Wasabi

[Django](https://www.djangoproject.com/) is validated to use with Wasabi S3 storage. It is a web framework designed to create websites using Python.

## Designing a Basic Web Framework in Django

1. Start by installing Django and setting up a project.

```python
$ pip install django
```
2. To confirm your installation was successful, run the following command, and you should see available sub-commands.

```python
$ django-admin

                Type 'django-admin help ' for help on a specific subcommand.

                Available subcommands:

                [django]
                    check
                    compilemessages
                    createcachetable
                    dbshell
                    diffsettings
                    dumpdata
                    flush
                    inspectdb
                    loaddata
                    makemessages
                    makemigrations
                    migrate
                    runserver
                    sendtestemail
                    shell
                    showmigrations
                    sqlflush
                    sqlmigrate
                    sqlsequencereset
                    squashmigrations
                    startapp
                    startproject
                    test
                    testserver
```
3. To create a new project, you can use the startproject command.

```python
$ django-admin startproject
```
4. This will automatically create the basic Django framework. Navigate inside your project where the manage.py file has been created. Use the following command to run the server.

```python
$ python manage.py runserver
```
5. You will see the output below, which indicates your server is now running on port 8000.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-09_at_9.png)
6. If you go to port 8000 on your web browser, you will see the Django server running on your system.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-09_at_9(1).png)

## Enabling Your Django Project to Communicate With Wasabi S3 Storage

1. Install [django-storages](https://django-storages.readthedocs.io/en/latest/).

```plaintext
$ pip install django-storages
```
2. Install [boto3](https://pypi.org/project/boto3/) library.

```plaintext
$ pip install boto3
```
3. Add `storages` to your INSTALLED_APPS inside the settings.py module, as shown below:

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-11_at_11.png)
4. Configure the settings.py module to [support the S3 backend](https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html).

The following is an example of a configuration that would allow your Django web application to communicate with Wasabi. Be sure to use your own details.

```powershell
AWS_ACCESS_KEY_ID = 'Wasabi-Access-Key'
        AWS_SECRET_ACCESS_KEY = 'Wasabi-Secret-Key'
        AWS_STORAGE_BUCKET_NAME = 'Wasabi-Bucket-Name'
        AWS_S3_ENDPOINT_URL = 'https://s3.us-east-2.wasabisys.com'
```

This code example shows the use of Wasabi's us-east-2 storage region. You can use any other appropriate [Wasabi service URL](/v1/docs/what-are-the-service-urls-for-wasabis-different-storage-regions).

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-11_at_11(1).png)

You can design and let Django put your static assets in your Wasabi bucket so that you can connect it directly to your deployment script.

```plaintext
$ python manage.py collectstatic
```

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-11_at_11(2).png)

You can see that those files are now in the Wasabi bucket and can be interacted with your framework from there directly.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/screen_shot_2020-08-12_at_12.png)

Note that the example above is **only** a sample to illustrate the settings needed to communicate with Wasabi Hot Cloud Storage. Wasabi expects users to build and develop their own Django framework application as per their requirement(s) and use the above settings to configure the S3 storage library.