[DEPR]: DEFAULT_FILE_STORAGE and STATICFILES_STORAGES

RFC Start Date

N/A -- Already Accepted

Target Plan Accepted Date

N/A -- Already Accepted

Target Transition Unblocked Date

Immediately -- Transition Already Unblocked

Earliest Breaking Changes Unblocked Date

Python settings: 2025-09-08 (already past)
YAML settings: 2025-10-24 (after Ulmo cut)

Rationale

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

We recently landed this settings change on edx-platform master and operators running on master will need to edit their config accordingly.

Description

These Django settings:

• DEFAULT_FILE_STORAGE
• STATICFILES_STORAGE

have been replaced with with:

• STORAGES

See the django-storages upgrade docs for more details.

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.

Task List

No response