diff --git a/doc/How to build - Mac OS.md b/doc/How to build - Mac OS.md
index 113c5cec0f..a35c7f962a 100644
--- a/doc/How to build - Mac OS.md	
+++ b/doc/How to build - Mac OS.md	
@@ -80,6 +80,27 @@ This is set in the property list file
 
 To remove the limitation, simply delete the key `MinimumSDKVersion` from that file.
 
+## Troubleshooting
+
+### `CMath::CMath` target not found
+
+At the moment (20.2.2024) PrusaSlicer cannot be built with CMake 3.28+. Use [CMake 3.27](https://github.com/Kitware/CMake/releases/tag/v3.27.9) instead. 
+If you install the CMake application from [universal DMG](https://github.com/Kitware/CMake/releases/download/v3.27.9/cmake-3.27.9-macos-universal.dmg), you can invoke the CMake like this:
+
+```
+/Applications/CMake.app/Contents/bin/cmake
+```
+
+### Running `cmake -GXCode` fails with `No CMAKE_CXX_COMPILER could be found.` 
+
+- If XCode command line tools wasn't already installed, run:
+    ```
+     sudo xcode-select --install
+    ```
+- If XCode command line tools are already installed, run:
+    ```
+    sudo xcode-select --reset
+    ```
 
 # TL; DR