diff --git a/README.md b/README.md
index 74edc301d313d4792e0e74f0ad31e062709b52c3..8225347a0063552a3d7b29b83c57815eceff2fb6 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,19 @@
 # Ludwig Integration Test
 
-## Running integration test
+This repo contains the integration test for Ludwig.
+It is based on Selenium, which requires some additional packages to be available, therefore
+it is recommended to run the integration test inside of docker.
+It uses a docker bind volume to include the tests from the `tests` directory in the container.
+
+## Running the integration test
 
 ```bash
-docker compose run integration pytest
+export FE_VERSION=""    # container tag; defaults to latest
+export BE_VERSION=""    # container tag; defaults to latest
+docker compose run --rm integration pytest
 ```
+
+## Work in progress
+
+- Database migrations & data fixtures
+- Test isolation (wrt. data in the DB)