diff --git a/web/content/docs/devguide/troubleshooting/conan.pandoc b/web/content/docs/devguide/troubleshooting/conan.pandoc
index 848d914378f0009223727b4d1843806a27b836f9..3b7710c19931ccd5098497f8f3edc4cb80c5c5f6 100644
--- a/web/content/docs/devguide/troubleshooting/conan.pandoc
+++ b/web/content/docs/devguide/troubleshooting/conan.pandoc
@@ -31,3 +31,14 @@ Requirements
 ```
 
 You can always delete the Conan cache directory in `$HOME/.conan` to start fresh. This can fix errors.
+
+
+### ERROR: Invalid setting 'X' is not a valid 'settings.compiler.version' value
+
+In `~/.conan/settings.yml` it is defined which compiler versions are supported by Conan on your machine. Unfortunately (and this is also a bit inconvenient) this file is not updated automatically when upgrading Conan. Three possible ways to fix it:
+
+- add the missing value to the file by yourself
+- simply delete the file, Conan will re-create it on the next run (easiest method)
+- when upgrading Conan it creates a file `~/.conan/settings.new.yml` or similar which you can just rename to `~/.conan/settings.yml`
+
+See also: http://docs.conan.io/en/latest/faq/troubleshooting.html#error-invalid-setting