Apache httpd is a fast, production level HTTP server. When serving your application with one of the WSGI servers listed in Deploying to Production, it is often good or necessary to put a dedicated HTTP server in front of it. This “reverse proxy” can handle incoming requests, TLS, and other security and performance concerns better than the WSGI server.
httpd can be installed using your system package manager, or a pre-built executable for Windows. Installing and running httpd itself is outside the scope of this doc. This page outlines the basics of configuring httpd to proxy your application. Be sure to read its documentation to understand what features are available.
Acquiring and configuring a domain name is outside the scope of this doc. In general, you will buy a domain name from a registrar, pay for server space with a hosting provider, and then point your registrar at the hosting provider’s name servers.
To simulate this, you can also edit your
hosts file, located at
/etc/hosts on Linux. Add a line that associates a name with the
Modern Linux systems may be configured to treat any domain name that
.localhost like this without adding it to the
The httpd configuration is located at
Linux. It may be different depending on your operating system. Check the
docs and look for
Remove or comment out any existing
DocumentRoot directive. Add the
config lines below. We’ll assume the WSGI server is listening locally at
LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so ProxyPass / http://127.0.0.1:8000/ RequestHeader set X-Forwarded-Proto http RequestHeader set X-Forwarded-Prefix /
LoadModule lines might already exist. If so, make sure they are
uncommented instead of adding them manually.
Then Tell Werkzeug it is Behind a Proxy so that your application uses the
X-Forwarded-Host are automatically
Assuming the static files are expected to be available under the
/static/ URL, and are stored at
/home/project/static/, add the
following to the config above.
Alias /static/ /home/project/static/