diff --git a/docs/faq.md b/docs/faq.md
index 4fdf839fb..a3dccf9fc 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -15,3 +15,7 @@ This question is solved
 
 The reason for using only the private key here is that one is able to calculate the public key easily from the private
 key (`openssl rsa -in rsa.key -pubout > rsa.pem`).
+
+## My installation broke after updating. What do I need to fix?
+
+Check the [migration log](https://www.authelia.com/docs/configuration/migration.html) for any steps you need to follow. It's a good idea to consult this prior to running an update.