whitenoise

What it is and what it does

WhiteNoise is a WSGI middleware that allows Python web applications to serve their own static files without relying on external services like nginx or Amazon S3. It wraps any WSGI-compatible application and intercepts requests for static assets, handling them efficiently within the application itself. This makes deployments simpler and more self-contained, particularly valuable on Platform-as-a-Service providers where external services may be unavailable or costly.

The package automates several static-file best practices: it compresses responses using gzip and Brotli formats with proper Accept-Encoding and Vary header handling, sets far-future cache headers on immutable content, and includes special auto-configuration for Django applications. It is designed to work alongside CDNs for high-traffic sites, so adopting it does not sacrifice performance for simplicity.

Use it for:

• Deploy a Django app to Heroku or OpenShift without configuring external static file storage.
• Serve CSS, JavaScript, and images from a containerized Python application without nginx.
• Simplify local development by eliminating separate static file server setup.
• Reduce deployment complexity for small-to-medium traffic sites by bundling static serving.
• Enable gzip and Brotli compression of static assets with automatic header management.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

WhiteNoise serves static files directly from a Python WSGI application without requiring a separate web server or CDN, handling compression, caching headers, and best practices automatically.

Yes. WhiteNoise is production-stable, actively maintained, has zero security vulnerabilities, requires no external dependencies, and solves a common deployment pain point. Install it if you are deploying a WSGI or Django application to a managed platform or containerized environment where you want static files bundled with the app.

Install

whitenoise on PyPI

pip install whitenoise

uv add whitenoise

poetry add whitenoise

Installing whitenoise

Before you install

Low install friction with no runtime dependencies. Actively maintained as of 2026-02-27 with recent commits, and marked Production/Stable.

License in practice

MIT license permits commercial and private use with minimal restrictions—straightforward permissive terms suitable for most projects.

Quickstart

pip install whitenoise==6.12.0

from whitenoise import WhiteNoise

app = WhiteNoise(application, root='staticfiles')

Requires Python 3.10 or later; application must be WSGI-compatible.

Verify before relying

• Performance comparison with dedicated static file servers under high traffic loads.
• Specific CDN integration patterns and recommended configurations.
• Exact performance characteristics when serving compressed content formats.

Package facts

Evidence: whitenoise-6.12.0-py3-none-any.whl

Keywords: Django

Tags

More Middleware packages