Document HTTP test mode dependencies

1 files changed, 17 insertions, 0 deletions

diff --git a/TESTING b/TESTING
index d06f400..4a195d7 100644
--- a/TESTING
+++ b/TESTING
@@ -32,6 +32,23 @@ to HTTP mode if you are changing the CGI code by running:
 The protocol being used during a test run is exposed in the GTT_PROTO
 environment variable passed to implementations.
 
+HTTP mode test dependencies
+---------------------------
+
+HTTP tests work via password access rather than key access,
+so the `htpasswd` binary must be in your `PATH`.
+In debian this can be accomplised by installing `apache2-utils`.
+
+HTTP tests require starting an HTTP server on an unused port.
+The test suite implements this using `lighttpd`,
+so that binary must be in your `PATH`.
+In debian this can be accomplished by installing `lighttpd`.
+This starts it by default, so you probably want to run
+`systemctl disable --now lighttpd.service` to stop it.
+
+This defaults to starting at 8080 and walking up to find a free one.
+If there is a better port to use set `HTTP_FIRST_TEST_PORT`.
+
 The fundamental parts of the `testing/` directory are
 =====================================================