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.