diff --git a/README.md b/README.md
index 99ed81fa..07cf144c 100644
--- a/README.md
+++ b/README.md
@@ -136,3 +136,14 @@ To build you should clone [SDL](https://github.com/libsdl-org/SDL) from `SDL2` b
 2) Compile `./waf build`.
 3) Navigate to `build` and copy your compiled SDL2.framework there, then add your client dylibs to `build/ios/cl_dlls` and any other dylibs to `build/ios/dlls` (You can also run `scripts/ios/buildhlsdk.sh` instead to automatically create an ipa with hlsdk dylibs)
 4) Run `scripts/ios/createipa.sh` to create an installable ipa
+
+### Running tests
+
+There are two kinds of tests.
+
+Standalone unit tests are enabled with `--enable-tests` passed to `./waf configure` and can be run with `./waf --alltests`.
+
+Engine-embedded tests are enabled with `--enable-engine-tests`. They require engine context but no game assets. To run them:
+
+0) Install engine: `./waf install --destdir=<directory>`
+1) Run from the install directory: `./xash3d -dev 2 -runtests`