README: running and testing

README.md

@@ -15,6 +15,24 @@ This image requires a `schleuderd` running somewhere and accessible via `TCP/IP`
 
 **Please be advised that `schleuderd` does not, at this time, offer authentication, nor does it support `TLS`-encrypted connections. This means that `webschleuder3` should be run on the same physical machine, or at least on a connection that precludes the possibility of malicious connections being made to `schleuderd`.** You have been warned!
 
+## Running and testing
+
+You need `docker`, obviously. So first, [go and install it](https://docs.docker.com/engine/installation/). Then get `schleuderd` running. We'll assume you're [using the `schlocker3` docker image](https://git.occrp.org/libre/schlocker3/#running-and-testing) for this. Once you have `schlocker3` running, run `webschlocker3`:
+
+```
+$ git clone https://git.occrp.org/libre/webschlocker3.git
+$ docker build -t 'webschlocker3' webschlocker3/
+$ docker run --rm --name webschlocker-test --link schlocker-test -e WEBSCHLOCKER_CONFIG_SCHLEUDERD_URI="http://schlocker-test:4567/" webschlocker3
+```
+
+By default `weschleuder3` listens on port `3000` (you can change this by setting `$WEBSCHLOCKER_BIND_PORT` docker envvar); you can get the IP of the container with:
+
+```
+docker inspect -f '{{.NetworkSettings.IPAddress}}' schlocker-test
+```
+
+Once you have that, navigate your browser to `http://<IP-of-the-container>:3000/` and log-in with user `root@localhost`, password `slingit!`.
+
 ## Environment variables
 
  - `WEBSCHLOCKER_CONFIG_HOSTNAME` (default: container's hostname)