From 102b2da34a843c36575b29e938ac0f917b785ff9 Mon Sep 17 00:00:00 2001 From: Eliot Berriot 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 000000000..ad3db61a2 --- /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 577066fc3..01ed47a4a 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