[DEPR]: DEFAULT_FILE_STORAGE and STATICFILES_STORAGES

Proposal Date

2025-16-09

Ticket Acceptance Date

?

Technology Removal Date

(as early as Oct 9)

First Open edX Named Release Without This Functionality

Ulmo

Rationale

RFC Start Date
N/A -- Already Accepted

Target Plan Accepted Date
N/A -- Already Accepted

Target Transition Unblocked Date
Immediately -- Transition Already Unblocked

Rationale
This is a mandatory part of the django 4.2->5.2 upgrade.

Description
These Django settings:

1. DEFAULT_FILE_STORAGE
2. STATICFILES_STORAGE

have been replaced with with:

• STORAGES

See the https://github.com/openedx/edx-platform/pull/37002 for more details. For discovery PR is still open.

For operators using a custom DJANGO_SETTINGS_MODULE
Update your config now. The old settings no longer work.

For operators using a YAML File
We have included a temp backwards compatibility shim so that the old settings are still respected when specified via YAML.

This shim will be removed right after the Ulmo cut (as early as Oct 9) so please update your config in the next month.

Migration

No response

Additional Info

No response