Skip to main content
Help us improve Python packaging – donate today!

Radically simplified static file serving for WSGI applications

Project Description

Build Status Latest PyPI version GitHub project

Radically simplified static file serving for Python web apps

With a couple of lines of config WhiteNoise allows your web app to serve its own static files, making it a self-contained unit that can be deployed anywhere without relying on nginx, Amazon S3 or any other external service. (Especially useful on Heroku, OpenShift and other PaaS providers.)

It’s designed to work nicely with a CDN for high-traffic sites so you don’t have to sacrifice performance to benefit from simplicity.

WhiteNoise works with any WSGI-compatible app but has some special auto-configuration features for Django.

WhiteNoise takes care of best-practices for you, for instance:

  • Serving compressed content (gzip and Brotli formats, handling Accept-Encoding and Vary headers correctly)
  • Setting far-future cache headers on content which won’t change

Worried that serving static files with Python is horribly inefficient? Still think you should be using Amazon S3? Have a look at the Infrequently Asked Questions.

To get started, see the documentation.

Release history Release notifications

History Node

4.0b4

History Node

4.0b3

History Node

4.0b2

History Node

4.0b1

This version
History Node

3.3.1

History Node

3.3.0

History Node

3.2.3

History Node

3.2.2

History Node

3.2.1

History Node

3.2

History Node

3.1

History Node

3.0

History Node

3.0rc1

History Node

3.0b1

History Node

2.0.6

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0

History Node

1.0.6

History Node

1.0.5

History Node

1.0.4

History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0

History Node

0.13

History Node

0.12

History Node

0.11

History Node

0.10

History Node

0.9

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
whitenoise-3.3.1-py2.py3-none-any.whl (21.3 kB) Copy SHA256 hash SHA256 Wheel 2.7 Sep 23, 2017
whitenoise-3.3.1.tar.gz (32.5 kB) Copy SHA256 hash SHA256 Source None Sep 23, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page