From c6cb00de483fa8d7fbfb9cabe41754694b34a405 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= <sporiff@funkwhale.audio>
Date: Wed, 18 Jan 2023 14:58:03 +0100
Subject: [PATCH] docs: Add changelog for compose upgrade.

Part-of: <https://dev.funkwhale.audio/funkwhale/funkwhale/-/merge_requests/2318>
---
 changes/changelog.d/compose.doc | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 changes/changelog.d/compose.doc

diff --git a/changes/changelog.d/compose.doc b/changes/changelog.d/compose.doc
new file mode 100644
index 000000000..1888fd6d2
--- /dev/null
+++ b/changes/changelog.d/compose.doc
@@ -0,0 +1,14 @@
+The Docker instructions now use the updated Docker compose plugin. If you previously used the ``docker-compose`` standalone installation, do the following while upgrading:
+
+1. Download the `Docker compose plugin <https://docs.docker.com/compose/install/linux/#install-using-the-repository>`_
+2. Stop your containers using the **docker-compose** syntax.
+
+.. code-block:: sh
+   sudo docker-compose down
+
+3. Bring the containers back up using the **docker compose** syntax.
+
+.. code-block:: sh
+   sudo docker compose up -d
+
+After this you can continue to use the **docker compose** syntax for all Docker management tasks.