From 01c978cdcf5d26fd7f766c2313896e1b3313ead3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ciar=C3=A1n=20Ainsworth?= <sporiff@funkwhale.audio>
Date: Wed, 27 Jul 2022 18:18:29 +0000
Subject: [PATCH] Resolve "Provide docs to help with migration Debian 10 -> 11"
---
api/config/settings/common.py | 2 +-
changes/changelog.d/1562.doc | 1 +
.../installation_docs/debian.md | 4 ++--
.../upgrade_docs/debian.md | 22 +++++++++++++++++++
4 files changed, 26 insertions(+), 3 deletions(-)
create mode 100644 changes/changelog.d/1562.doc
diff --git a/api/config/settings/common.py b/api/config/settings/common.py
index f75443e77..d7beb00bc 100644
--- a/api/config/settings/common.py
+++ b/api/config/settings/common.py
@@ -20,7 +20,7 @@ LOGLEVEL = env("LOGLEVEL", default="info").upper()
"""
Default logging level for the Funkwhale processes
-Available levels:
+Available levels:
- ``debug``
- ``info``
diff --git a/changes/changelog.d/1562.doc b/changes/changelog.d/1562.doc
new file mode 100644
index 000000000..09ae5f8c9
--- /dev/null
+++ b/changes/changelog.d/1562.doc
@@ -0,0 +1 @@
+Added virtualenv upgrade instructions for Debian (#1562).
diff --git a/docs/administrator_documentation/installation_docs/debian.md b/docs/administrator_documentation/installation_docs/debian.md
index 47cbb1579..ba9873acc 100644
--- a/docs/administrator_documentation/installation_docs/debian.md
+++ b/docs/administrator_documentation/installation_docs/debian.md
@@ -15,11 +15,11 @@ We support [Debian](https://debian.org) and Debian-based Linux distributions. Fo
export FUNKWHALE_VERSION={sub-ref}`version`
```
-- Install `curl` and `unzip` - utilities used later.
+- Install `curl`
```{code} bash
sudo apt update # update apt cache
- sudo apt install curl unzip
+ sudo apt install curl
```
## 1. Install Funkwhale dependencies
diff --git a/docs/administrator_documentation/upgrade_docs/debian.md b/docs/administrator_documentation/upgrade_docs/debian.md
index 031bf12d6..79cb0cc77 100644
--- a/docs/administrator_documentation/upgrade_docs/debian.md
+++ b/docs/administrator_documentation/upgrade_docs/debian.md
@@ -2,6 +2,28 @@
If you installed Funkwhale following the [Debian guide](../installation_docs/debian), follow these steps to upgrade.
+:::{dropdown} Upgrading to a new version of Python
+:icon: alert
+:color: warning
+
+If you upgrade your Python version, you need to update your virtualenv. Python is updated with each new version of Debian.
+
+To upgrade your virtualenv:
+
+1. Change to your api directory.
+
+ ```{code-block} bash
+ cd /srv/funkwhale/api
+ ```
+
+2. Rerun `poetry install` to reinstall your dependencies in a new virtualenv.
+
+ ```{code-block} bash
+ poetry install
+ ```
+
+:::
+
## Download the updated files
1. SSH into your server.
--
GitLab