diff --git a/CMakeLists.txt b/CMakeLists.txt
index a9b83bd..294e923 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -6,8 +6,10 @@ cmake_minimum_required (VERSION 3.23.1)
 project(openmoonray)
 
 list(APPEND CMAKE_MESSAGE_CONTEXT ${PROJECT_NAME})
-if(NOT DEFINED CMAKE_INSTALL_PREFIX OR ${CMAKE_INSTALL_PREFIX} STREQUAL "/usr/local")
-    set(CMAKE_INSTALL_PREFIX ${CMAKE_SOURCE_DIR}/release)
+# Set default install prefix to local release directory if not explicitly provided
+# or if default system path (/usr/local) is being used.
+if(NOT DEFINED CMAKE_INSTALL_PREFIX OR CMAKE_INSTALL_PREFIX STREQUAL "/usr/local")
+    set(CMAKE_INSTALL_PREFIX "${CMAKE_CURRENT_SOURCE_DIR}/release")
 endif()
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake_modules/cmake)
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/rats/cmake)
diff --git a/docs/build-troubleshooting.md b/docs/build-troubleshooting.md
new file mode 100644
index 0000000..ef4466e
--- /dev/null
+++ b/docs/build-troubleshooting.md
@@ -0,0 +1,18 @@
+# Build Troubleshooting
+
+## Common Errors
+
+### Missing submodules
+Fix:
+git submodule update --init --recursive
+
+### Missing dependencies
+Install:
+- libtbb-dev
+- libjsoncpp-dev
+- libopenexr-dev
+
+### TBB not found (modern systems)
+Use:
+-DCMAKE_PREFIX_PATH=/usr/lib/x86_64-linux-gnu/cmake
+