Repository navigation
[DEPR]: DEFAULT_FILE_STORAGE and STATICFILES_STORAGES #37333
Description
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_STORAGESTATICFILES_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
Activity
kdmccormick commentedon Sep 8, 2025
FYI @pdpinch -- This may affect your instance when you merge in the latest master.
kdmccormick commentedon Sep 8, 2025
For reference, this is how 2U updated their devstack's config to handle this breaking change: edx/devstack#172
jcapphelix commentedon Oct 8, 2025
Is this still planned with same dates as mentioned in DEPR or is this also pushed to Oct 23 ?
kdmccormick commentedon Oct 8, 2025
good question. it's pushed until whenever the Ulmo cut is -- currently, Oct 23rd.
dianakhuang commentedon Oct 30, 2025
@kdmccormick check how credentials handled this and how to write good release notes.
dianakhuang commentedon Jan 8, 2026
Ulmo cut happened, so this is now unblocked. This will be going away with Verawood, so will check back in then.