diff --git a/INSTALL.md b/INSTALL.md
index 6378e4195100c760fb21342fc6d08c90136573b6..7aaa94e85466a3761cec9c73c07d47116c07ba96 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -343,9 +343,24 @@ Built client could be find in `build/Jami`
 
 - These environment variables will be temporarily set when using build-windows.py to run tests.
 
+## Troubleshooting
+
+Build errors may occur if daemon dependencies have been updated since the last build, as the script may not fully detect or rebuild them in the correct order. For the same reason, you may also occasionally encounter linker errors.
+
+To resolve this, clean and restart the installation to ensure a fresh rebuild of all components (delete all temporary files generated by the build process):
+
+```bash
+./build.py --clean
+./build.py --install
+```
+
 ## Debugging
 
-Compile the client with with `-DCMAKE_BUILD_TYPE=Debug`.
+Compile the client with `-DCMAKE_BUILD_TYPE=Debug`. Then, if you want to enable logging when running `jami`, launch it with `-d` or `--debug`.
+
+To diagnose a crash, use GDB:
 
-Then, if you want to enable logging when running `jami`, launch it
-with `-d` or `--debug`.
+```sh
+./build.py --install --debug
+gdb -ex run --args ./jami --debug
+```