diff --git a/doc/PRE_UPGRADE.md b/doc/PRE_UPGRADE.md
new file mode 100644
index 0000000..7405a97
--- /dev/null
+++ b/doc/PRE_UPGRADE.md
@@ -0,0 +1,2 @@
+GoToSocial takes some time (from some seconds to some minutes)  after each version upgrades to perform various things, like database migration or optimizations.  
+If your instance is not accessible, please be patient and **do not** restart it manually at the risk of breaking everything!
\ No newline at end of file