summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--INSTALL22
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`.