2.1 KiB

Raw Blame History

Upgrade your Debian Funkwhale installation

If you installed Funkwhale following the Debian guide, follow these steps to upgrade.

Cleanup old funkwhale files

Stop the Funkwhale services.
```
sudo systemctl stop funkwhale.target
```
Navigate to your Funkwhale directory.
```
cd /srv/funkwhale
```
Remove the old files.
```
sudo rm -Rf api/* front/* venv
```

Download Funkwhale

Export the Funkwhale version you want to update to. You'll use this in the rest of the commands in this guide.
```
export FUNKWHALE_VERSION={sub-ref}`version`
```
Follow the Download Funkwhale instructions in the installation guide.
Follow the Install the Funkwhale API instructions in the installation guide.

Update your reverse proxy configuration

To ensure your reverse proxy is up-to-date with changes, you should regenerate your Nginx configuration with each upgrade. To do this:

:::{include} /administrator/installation/debian.md :start-after: Nginx update instructions :end-before: Instructions end :::

Once you've updated your configuration, reload Nginx.

# systemctl reload nginx

Update your Funkwhale instance

Once you have downloaded the new files, you can update your Funkwhale instance. To do this:

Install or upgrade all OS dependencies using the dependencies script.
```
sudo api/install_os_dependencies.sh install
```

Collect the new static files to serve.

sudo venv/bin/funkwhale-manage collectstatic --no-input

Apply new database migrations.

sudo -u funkwhale venv/bin/funkwhale-manage migrate

Restart the Funkwhale services.
```
sudo systemctl start funkwhale.target
```

That's it! You've updated your Funkwhale pod. You should now see the new version running in your web browser.