Serving Static Files in Development
In this page:
Automatic Serving with runserver
When DEBUG=True, django.contrib.staticfiles automatically wires up a URL pattern so runserver can serve every static file it finds, no manual configuration needed.
Note: Just start the server and reference files with {% static %} — Django handles the rest.
Example: Automatic Serving with runserver
When DEBUG=True, django.contrib.staticfiles automatically wires up a URL pattern so runserver can serve every static file it finds, no manual configuration needed.
python manage.py runserver⚠️ Run this command in your terminal.
Adding Extra Static Directories
STATICFILES_DIRS lists additional folders (outside any single app) that should also be searched for static files, such as a project-wide static/ directory.
Example: Adding Extra Static Directories
STATICFILES_DIRS lists additional folders (outside any single app) that should also be searched for static files, such as a project-wide static/ directory.
# settings.py
STATICFILES_DIRS = [
BASE_DIR / 'static',
]Why This Doesn't Work in Production
The development server's static file serving is intentionally simple and unoptimized. In production, DEBUG is False and this auto-serving stops, so a real web server or collectstatic-backed setup is required instead.
Warning: Never set DEBUG=True in production just to keep static files working — it also exposes sensitive debug information.
Example: Why This Doesn't Work in Production
The development server's static file serving is intentionally simple and unoptimized. In production, DEBUG is False and this auto-serving stops, so a real web server or collectstatic-backed setup is required instead.
# settings.py (production)
DEBUG = False
# Static files now need collectstatic + a real web server- Relying on Django's development static file serving in production — it's slow and insecure at scale, meant only for local development.
- Forgetting DEBUG=True is required for runserver to auto-serve static files without extra URL configuration.
- Not restarting the development server after adding a new static/ directory to STATICFILES_DIRS.
- Django's runserver automatically serves static files when DEBUG is True.
- This convenience is not meant for production — real deployments use a web server or CDN instead.
- STATICFILES_DIRS lets you add extra folders beyond each app's own static/ directory.
- Static files update immediately on refresh during development, no collectstatic step needed.
Chapter Quiz — Complete all 8 topics to unlock
0/8 topics done
Complete these topics first: