diff --git a/README_SETUP.md b/README_SETUP.md index 3a27cb5e34d1785991a2379c703561926913e96a..9b8a6457d9a0b79fe0d6acf3e8df9294f0074981 100644 --- a/README_SETUP.md +++ b/README_SETUP.md @@ -63,10 +63,16 @@ See `build.properties.d/00_default.properties` for more information. ## Test +* See [DEPENDENCIES](DEPENDENCIES#for-unit-testing) for the requirements to run the unit tests. * Run `make test` to compile/copy the web interface and the tests to a newly created `public` folder. * Run `make run-test-server` to start a python http server. * The test suite can be started with `firefox http://localhost:8000/`. +* *On WSL (as of Feb 2024, WSL v2.0.14.0)*, port 8000 is sometimes not properly forwarded to the host + resulting in an unreachable test suite. Switching to a different port can be done easily + by using the `TEST_PORT` environment variable, e.g. with `TEST_PORT=8111 make + run-test-server`. Using the X11 `firefox` from within WSL always works. +* To run the test suite non-interactively (as in CI/CD) use `make -d run-qunit` ## Clean