[DEPR]: DEFAULT_FILE_STORAGE and STATICFILES_STORAGES

[kdmccormick]

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

[kdmccormick]

FYI @pdpinch -- This may affect your instance when you merge in the latest master.

[kdmccormick]

For reference, this is how 2U updated their devstack's config to handle this breaking change: edx/devstack#172

[jcapphelix]

Is this still planned with same dates as mentioned in DEPR or is this also pushed to Oct 23 ?

[kdmccormick]

good question. it's pushed until whenever the Ulmo cut is -- currently, Oct 23rd.