diff options
-rw-r--r-- | INSTALL | 22 |
1 files changed, 22 insertions, 0 deletions
@@ -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`. |