Waitress¶
Waitress is a pure Python WSGI server.
It is easy to configure.
It supports Windows directly.
It is easy to install as it does not require additional dependencies or compilation.
It does not support streaming requests, full request data is always buffered.
It uses a single process with multiple thread workers.
This page outlines the basics of running Waitress. Be sure to read its
documentation and waitress-serve --help
to understand what features
are available.
Installing¶
Create a virtualenv, install your application, then install
waitress
.
$ cd hello-app
$ python -m venv venv
$ . venv/bin/activate
$ pip install . # install your application
$ pip install waitress
Running¶
The only required argument to waitress-serve
tells it how to load
your application. The syntax is {module}:{app}
. module
is
the dotted import name to the module with your application. app
is
the variable with the application. If you’re using the app factory
pattern, use --call {module}:{factory}
instead.
# equivalent to 'from hello import app'
$ waitress-serve hello:app --host 127.0.0.1
# equivalent to 'from hello import create_app; create_app()'
$ waitress-serve --call hello:create_app --host 127.0.0.1
Serving on http://127.0.0.1:8080
The --host
option binds the server to local 127.0.0.1
only.
Logs for each request aren’t shown, only errors are shown. Logging can be configured through the Python interface instead of the command line.
Binding Externally¶
Waitress should not be run as root because it would cause your application code to run as root, which is not secure. However, this means it will not be possible to bind to port 80 or 443. Instead, a reverse proxy such as nginx or Apache httpd should be used in front of Waitress.
You can bind to all external IPs on a non-privileged port by not
specifying the --host
option. Don’t do this when using a revers
proxy setup, otherwise it will be possible to bypass the proxy.
0.0.0.0
is not a valid address to navigate to, you’d use a specific
IP address in your browser.