service/forum.md

@@ -264,6 +264,28 @@ To create and configure the API key:
 
      trocla set forum.torproject.org::discourse::mail_apikey plain
 
+## Upgrades
+
+Upgrades for Discourse must be triggered manually. In theory it would be
+possible to upgrade automatically, but this is discouraged by community members
+because it [can throw up some excitement every now and again depending on what
+plugins you
+have](https://meta.discourse.org/t/is-it-possible-to-upgrade-discourse-automatically/246531/5).
+
+To trigger an upgrade, simply navigate to the [Upgrade][] page in the Discourse
+admin section and hit `Upgrade all`, then `Start Upgrade`.
+
+Sometimes, this button is greyed out because an upgrade for `docker_manager`
+is available, and it must be installed before the other components are
+upgraded. Click the `Upgrade` button next to it.
+
+Discourse can also be upgraded via the command-line:
+
+    cd /srv/discourse
+    ./launcher rebuild
+
+[Upgrade]: https://forum.torproject.org/admin/upgrade
+
 ## Onion service
 
 An onion service is configured on the machine using Puppet, listening on ports