From 336ca3ffe782dd44c401f6af31832d3eb0209fc6 Mon Sep 17 00:00:00 2001
From: Martin Zimmermann <info@posativ.org>
Date: Thu, 12 Dec 2013 11:28:30 +0100
Subject: [PATCH] add deployment docs for mod_wsgi

---
 docs/docs/quickstart.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/docs/quickstart.rst b/docs/docs/quickstart.rst
index fb5ac14..96f3696 100644
--- a/docs/docs/quickstart.rst
+++ b/docs/docs/quickstart.rst
@@ -185,3 +185,38 @@ To execute Isso, use a command similar to:
 
     $ export ISSO_SETTINGS="/path/to/isso.cfg"
     $ gunicorn -b localhost:8080 -w 4 --preload isso.run
+
+mod_wsgi
+^^^^^^^^
+
+I have no experience at all with `mod_wsgi`, most things are taken from
+`Flask: Configuring Apache <http://flask.pocoo.org/docs/deploying/mod_wsgi/#configuring-apache>`_:
+
+.. code-block:: xml
+
+    <VirtualHost *>
+        ServerName example.org
+
+        WSGIDaemonProcess isso user=... group=... threads=5
+        WSGIScriptAlias / /var/www/isso.wsgi
+    </VirtualHost>
+
+Now, you need to create a new `isso.wsgi` file:
+
+.. code-block:: python
+
+    import os
+
+    from isso import make_app
+    from isso.core import Config
+
+    application = make_app(Config.load("/path/to/isso.cfg"))
+
+Unless you know how to preload the application, add a static session key to
+your `isso.cfg`:
+
+.. code-block:: ini
+
+    [general]
+    session-key = superrandomkey1
+