diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index d1f6ae5d..8bc0cfe0 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -5,6 +5,9 @@ List most common errors when using manta
 - Error with configuration file
 - Error with CSM CA root public certificate
 - Error when user tries to operate an compute node or a cluster it does not have access
+- Error when processing SAT files:
+  - Error when having `-` in variable files because the jinja template engine will process it as a math operator
+  - Error when a value is not found in vars file
 
 ??? info "**WIP**"
     This is work in progress