mod_wsgi

mod wsgi is an Apache HTTP Server module for hosting Python web applications that implement the WSGI specification ( PEP 3333 ). It has been used in production deployments for over 15 years and continues to be actively maintained. mod wsgi requires Python 3.10 or later and Apache 2.4. The 6.x release line is the current focus of development; see the documentation for the full version support policy. That site covers installation on the various supported platforms, the complete reference for WSGI configuration directives, the error code reference for WSGI log messages, deployment and hardening guides, and troubleshooting. The documentation sources live under docs in this repository and are built with Sphinx. mod wsgi on PyPI builds the mod wsgi Apache module against an existing Apache and Python installation on your host, and installs the mod wsgi-express command-line wrapper for running Apache with a generated configuration tuned for hosting a single WSGI application. mod wsgi-standalone on PyPI additionally installs a private build of Apache into your Python environment, for use on UNIX-like systems where no system Apache is available. mod wsgi-telemetry on PyPI is the out-of-process telemetry ingester and live UI that consume datagrams emitted when the WSGITelemetryService directive is enabled. It is distributed separately so that installations using the operating-system mod wsgi package, or any other manually-configured Apache, can adopt the telemetry pipeline without switching to the PyPI mod wsgi or mod wsgi-express packages. Before filing a bug report, work through the troubleshooting guide in the documentation. A substantial share of reports against mod wsgi turn out to be configuration, application, or third-party package issues rather than mod wsgi bugs. For suspected security issues, do not open a public issue. Submit a private security advisory via GitHub: See the security issues page in the documentation for the full disclosure process and the list of past CVEs. Pull requests are welcome. Small fixes and self-contained features can be sent straight through. For larger changes it is worth opening an issue first to discuss the approach, since mod wsgi sits across both the Apache and CPython C APIs and the relevant context is not always obvious from the code alone. src/server for the Apache module sources (C). src/express and the rest of src for the Python-side package that includes mod wsgi-express and the diagnostics WSGI applications. telemetry for the separately-distributed mod wsgi-telemetry package, which provides the out-of-process telemetry ingester, browser-based live UI and top -style curses monitor that consume datagrams emitted when the WSGITelemetryService directive is enabled. docs for the Sphinx documentation published to tests for the test suite and sample WSGI applications used by it. scripts for helper scripts, including the test runner. Building from source requires a complete Apache installation including its development headers ( apache2-dev or httpd-devel depending on distribution), and the Python development headers. See the documentation's installation page for the full prerequisites. mod wsgi is distributed under the Apache License, Version 2.0. See the LICENSE file in this repository for the full text.