|
| 1 | +Overview |
| 2 | +-------- |
| 3 | + |
| 4 | +The mod_wsgi package provides an Apache module that implements a WSGI |
| 5 | +compliant interface for hosting Python based web applications on top of the |
| 6 | +Apache web server. |
| 7 | + |
| 8 | +The primary package for mod_wsgi is available on the Python package index |
| 9 | +(PyPi) as ``mod_wsgi``. That package assumes that you have a suitable |
| 10 | +version of Apache pre-installed on your target system, and if you don't, |
| 11 | +installation of the package will fail. |
| 12 | + |
| 13 | +If you are on a UNIX like system (Linux, macOS) and need a version of |
| 14 | +Apache to be installed for you, you can use the ``mod_wsgi-standalone`` |
| 15 | +package on PyPi instead. When installing the ``mod_wsgi-standalone`` |
| 16 | +package it will first trigger the installation of the ``mod_wsgi-httpd`` |
| 17 | +package, which will result in a version of Apache being installed as |
| 18 | +part of your Python installation. Next the ``mod_wsgi`` package will be |
| 19 | +installed, with it using the version of Apache installed by the |
| 20 | +``mod_wsgi-httpd`` package rather than any system package for Apache. |
| 21 | + |
| 22 | +Note that this method of installation is only suitable for where you want |
| 23 | +to use ``mod_wsgi-expres``. It cannot be used to build mod_wsgi for use |
| 24 | +with your system Apache installation. This installation method will also |
| 25 | +not work on Windows. |
| 26 | + |
| 27 | +When installing mod_wsgi using this method, except that you will install |
| 28 | +the ``mod_wsgi-standalone`` package instead of the ``mod_wsgi`` package, |
| 29 | +you should follow installation and usage instructions outlined on the |
| 30 | +PyPi page for the ``mod_wsgi`` package. |
0 commit comments