# HG changeset patch
# User Mads Kiilerich <mads@kiilerich.com>
# Date 2024-09-23 01:30:00
# Node ID e6c7d225cac31599791da847845ab1dd617273c1
# Parent  3e017e766ef1c2c4a65c590efb78fe26ffa1a972

docs: Make mod_wsgi description more clear and actionable

diff --git a/docs/setup.rst b/docs/setup.rst
--- a/docs/setup.rst
+++ b/docs/setup.rst
@@ -631,10 +631,7 @@ that, you'll need to:
 
     WSGIRestrictEmbedded On
 
-- Create a WSGI dispatch script, like the one below. The ``WSGIDaemonProcess``
-  ``python-home`` directive will make sure it uses the right Python Virtual
-  Environment and that paste thus can pick up the right Kallithea
-  application.
+- Create a WSGI dispatch script, like `/srv/kallithea/wsgi.py`:
 
   .. code-block:: python
 
@@ -644,6 +641,10 @@ that, you'll need to:
       from paste.deploy import loadapp
       application = loadapp('config:' + ini)
 
+  We will use the ``WSGIDaemonProcess`` directive ``python-home`` to make sure
+  it uses the right Python Virtual Environment where paste loadapp will pick up
+  the right Kallithea application.
+
 - Add the necessary ``WSGI*`` directives to the Apache Virtual Host configuration
   file, like in the example below. Notice that the WSGI dispatch script created
   above is referred to with the ``WSGIScriptAlias`` directive.
@@ -665,8 +666,13 @@ that, you'll need to:
       WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 \
           python-home=/srv/kallithea/venv lang=C.UTF-8
       WSGIProcessGroup kallithea
-      WSGIScriptAlias / /srv/kallithea/dispatch.wsgi
+      WSGIScriptAlias / /srv/kallithea/wsgi.py
       WSGIPassAuthorization On
+      <Directory /srv/kallithea>
+          <Files wsgi.py>
+              Require all granted
+          </Files>
+      </Directory>
 
 
 Other configuration files