diff --git a/changes/changelog.d/713.doc b/changes/changelog.d/713.doc
new file mode 100644
index 0000000000000000000000000000000000000000..ad3db61a2d261847ede69a0a3e571b823ce3403f
--- /dev/null
+++ b/changes/changelog.d/713.doc
@@ -0,0 +1 @@
+Added documentation on mono-container docker upgrade (#713)
diff --git a/docs/upgrading/index.rst b/docs/upgrading/index.rst
index 577066fc3484fb48e748f49bbd678860268de7da..01ed47a4a9543587be4a8a98a284437f548dafe0 100644
--- a/docs/upgrading/index.rst
+++ b/docs/upgrading/index.rst
@@ -36,6 +36,39 @@ Docker setup
 If you've followed the setup instructions in :doc:`Docker`, upgrade path is
 easy:
 
+Mono-container installation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Basically, you need to pull the new container image, stop and delete your existing container,
+and relaunch a new one:
+
+.. parsed-literal::
+    export FUNKWHALE_VERSION="|version|"
+
+.. code-block:: shell
+
+    docker pull funkwhale/all-in-one:$FUNKWHALE_VERSION
+    docker stop funkwhale
+    docker rm funkwhale
+    docker run \
+        --name=funkwhale \
+        --restart=unless-stopped \
+        --env-file=/srv/funkwhale/.env \
+        -v /srv/funkwhale/data:/data \
+        -v /path/to/your/music/dir:/music:ro \
+        -e PUID=$UID \
+        -e PGID=$GID \
+        -p 5000:80 \
+        -d \
+        funkwhale/all-in-one:$FUNKWHALE_VERSION
+
+If you are not managing the container directly by hand, but use a third party tool such as Portainer,
+instructions will vary, but, as a rule of thumb, pulling the new version of the image, and relaunch
+a new container with the same arguments as the previous one (except for the image version) is enough.
+
+Multi-container installation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 .. parsed-literal::
 
     cd /srv/funkwhale