diff --git a/README.md b/README.md
index 2940e2a42d15505ccbbf68a107d7ee5e3f490e0b..46060729d020e592e1087eaa28effe4a1df96216 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,11 @@ Create a local conan package from the caosdb-cpplib repository
    path to the pem file in the `CAOSDB_SERVER_CERT` environment variable.
 7. Run with `ctest` in the build directory.
 
+### Troubleshooting ###
+
+- If you don't have `clang-tidy` installed, you can run the first `cmake` command with
+  `LINTING=OFF`: `cmake -D LINTING=OFF -B . ..`
+
 ## Formatting, style, linting ##
 
 `make format`