INSTALL: Document how to configure a front-end web server

This is mostly a generalisation of the example lighttpd configuration.
I haven't yet tried to configure any other web server.

Relates to #2.

1 files changed, 22 insertions, 0 deletions

diff --git a/INSTALL b/INSTALL
index b3c8933..9d98701 100644
--- a/INSTALL
+++ b/INSTALL
@@ -202,3 +202,25 @@ Lorry user permission to create subgroups and projects under them.
 
    * Set `downstream-host-type = local`
    * Set `local-base-directory =` *directory*
+
+## Configuring a front-end web server
+
+WEBAPP can run behind a front-end web server connected through FastCGI.
+To enable FastCGI, set `wsgi = yes` in `webapp.conf`.
+
+The front-end web server must be configured so that:
+
+* It does any necessary access control
+
+* It passes the request path as `PATH_INFO`, not split into
+  `SCRIPT_NAME` and `PATH_INFO`
+
+* It creates the FastCGI socket and starts WEBAPP as the Lorry user.
+  WEBAPP should normally be started with the command:
+
+        /usr/bin/lorry-controller-webapp --config=/etc/lorry-controller/webapp.conf
+
+An example configuration for lighttpd, and a corresponding systemd
+unit file, are included in the source as
+`etc/lighttpd/lorry-controller-webapp-httpd.conf` and
+`units/lighttpd-lorry-controller-webapp.service`.