Something wrong with the translation?

Help us to improve it on our translation platform

Upgrade your Debian Funkwhale installation

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

Cleanup old funkwhale files

  1. Stop the Funkwhale services.

    # systemctl stop
  2. Navigate to your Funkwhale directory.

    # cd /srv/funkwhale
  3. Remove the old files.

    # rm -Rf api/* front/* venv

Download Funkwhale

  1. 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=1.4.0
  2. Follow the Download Funkwhale instructions in the installation guide.

  3. Follow the Install the Funkwhale API instructions in the installation guide.

Upgrade your systemd unit files

To make sure you receive any updates made to unit files, download the latest versions from the repo.

# curl -L -o "/etc/systemd/system/" "$FUNKWHALE_VERSION/deploy/"
# curl -L -o "/etc/systemd/system/funkwhale-server.service" "$FUNKWHALE_VERSION/deploy/funkwhale-server.service"
# curl -L -o "/etc/systemd/system/funkwhale-worker.service" "$FUNKWHALE_VERSION/deploy/funkwhale-worker.service"
# curl -L -o "/etc/systemd/system/funkwhale-beat.service" "$FUNKWHALE_VERSION/deploy/funkwhale-beat.service"

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:

  1. Log in to a root shell to make changes to the config files

    $ sudo su
  2. Download the new Nginx templates from Funkwhale

    # curl -L -o /etc/nginx/funkwhale_proxy.conf "$FUNKWHALE_VERSION/deploy/funkwhale_proxy.conf"
    # curl -L -o /etc/nginx/sites-available/funkwhale.template "$FUNKWHALE_VERSION/deploy/nginx.template"
  3. Update the Nginx configuration with details from your .env file

    # set -a && source /srv/funkwhale/config/.env && set +a
    envsubst "`env | awk -F = '{printf \" $%s\", $$1}'`" \
       < /etc/nginx/sites-available/funkwhale.template \
       > /etc/nginx/sites-available/funkwhale.conf
  4. Check the configuration file to make sure the template values have been updated properly

    # grep '${' /etc/nginx/sites-available/funkwhale.conf

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:

  1. Install or upgrade all OS dependencies using the dependencies script.

    # api/ install
  2. Collect the new static files to serve.

    # venv/bin/funkwhale-manage collectstatic --no-input
  3. Apply new database migrations.

    # sudo -u funkwhale venv/bin/funkwhale-manage migrate
  4. Restart the Funkwhale services.

    # systemctl start

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