diff --git a/README.md b/README.md
index f6c4e4b8b3b9150dbe570b2a76c1076a2342cd23..03be852b4e74fbb3242ee428cbbbd3cbdfd4e625 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,19 @@ docker push gitlab.kitware.com:4567/f3d/f3d/linux-deps:latest
 docker push gitlab.kitware.com:4567/f3d/f3d/linux-deps:<hash>
 ```
 
+To test locally using a docker image:
+
+```
+Xephyr -br -ac -noreset -screen 1920x1080 :1
+DISPLAY=:1 xterm
+```
+
+```
+docker run -it -e DISPLAY=:1 -v="/tmp/.X11-unix:/tmp/.X11-unix:rw" --privileged ImageId /bin/bash
+```
+
+Then clone, configure, build and test f3d within the docker interactive shell.
+
 ## Windows
 
 In the `windows` dir, edit the `vtk.bat` and change the hash to checkout, open `Visual Studio x64 Native command`, then run