diff --git a/docs/installation/releases_en.md b/docs/installation/releases_en.md
index 30fbf5177..6c05f4cd9 100644
--- a/docs/installation/releases_en.md
+++ b/docs/installation/releases_en.md
@@ -238,3 +238,12 @@ run-parts --test /etc/periodic/daily
 ```
 ### Running Mix tasks
 ### Updating
+Generally, doing the following is enough:
+```sh
+# Download the new release
+su pleroma -s $SHELL -lc "./bin/pleroma_ctl update"
+
+# Migrate the database, you are advised to stop the instance before doing that
+su pleroma -s $SHELL -lc "./bin/pleroma_ctl migrate"
+```
+But you should **always check the release notes/changelog** in case there are config deprecations, special update steps, etc.