From e60d1cf450097e68c591f7ed8432f82f4e9d2e30 Mon Sep 17 00:00:00 2001 From: Ben Hutchings Date: Mon, 18 May 2020 17:06:16 +0100 Subject: 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. --- INSTALL | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) 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`. -- cgit v1.2.1