From 102b2da34a843c36575b29e938ac0f917b785ff9 Mon Sep 17 00:00:00 2001
From: Eliot Berriot <contact@eliotberriot.com>
Date: Thu, 7 Mar 2019 10:09:31 +0100
Subject: [PATCH] Fix #713: Added documentation on mono-container docker
upgrade
---
changes/changelog.d/713.doc | 1 +
docs/upgrading/index.rst | 33 +++++++++++++++++++++++++++++++++
2 files changed, 34 insertions(+)
create mode 100644 changes/changelog.d/713.doc
diff --git a/changes/changelog.d/713.doc b/changes/changelog.d/713.doc
new file mode 100644
index 0000000000..ad3db61a2d
--- /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 577066fc34..01ed47a4a9 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
--
GitLab