Funkwhale 1.3.0 release candidate

After a year of work, the Funkwhale team is proud to announce the release of the first release candidate for Funkwhale 1.3.0! Well, kind of. We had a few issues we needed to iron out with the first couple of candidates, but now we're ready to go! This release candidate gives admins the opportunity to test the new release and give feedback, and also gives translators the opportunity to check over strings before the official release.

1.3.0 is a huge upgrade to the Funkwhale codebase that requires a few migration steps. If you want to try the latest release and help us out by reporting issues, please read on.

All-in-one Docker deployment deprecation

With this release we are deprecating the All-in-one Docker deployment mechanism as mentioned in an earlier post. If you want to continue using Docker, you need to migrate to our multi-container setup. You can find migration instructions for this in our documentation.

Python upgrade note

Funkwhale 1.3.0 drops support for Python 3.6. If you're running Python 3.6 on your server, you must upgrade to Python 3.7 or above before upgrading Funkwhale.

Upgrade steps

Follow these steps to upgrade Funkwhale to 1.3.0-rc3

Docker deployments

Important: the new docker-compose.yml file uses Postgres 15. If you are using an old version of Postgres, you need to migrate to the new version or edit the compose file to match your existing postgres version. You can follow the upgrade instructions in our documentation.

  1. Upgrade your docker-compose.yml file. 1.3.0-rc3 brings important improvements and changes to the Docker setup that require an update to this file.

sh export FUNKWHALE_VERSION="1.3.0-rc3" cd /srv/funkwhale sudo docker-compose down mv docker-compose.yml docker-compose.bak curl -L -o /srv/funkwhale/docker-compose.yml "${FUNKWHALE_VERSION}/deploy/docker-compose.yml"

  1. The new Docker containers include Nginx files that read settings from your .env file. If you want to override these, uncomment the mounted files in the docker-compose.yml file and point them to your custom templates.
  2. Recommended: Docker suggests using the compose plugin over the standalone docker-compose script. We've updated our instructions to reflect this. To migrate to the new setup:

    1. Download the Docker compose plugin
    2. Stop your containers using the docker-compose syntax.

    sh sudo docker-compose down

    1. Bring the containers back up using the docker compose syntax.

    sh sudo docker compose up -d

    Non-Docker deployments

If you installed Funkwhale without Docker, follow the migration guide in our documentation.

Management command changes

This release candidate includes a new entrypoint for the script. All commands can now be run using the funkwhale-manage entrypoint. For example:

sh venv/bin/python import_files


sh venv/bin/funkwhale-manage import_files

Call for translations

With this update we changed our translation system from vue-gettext to vue-i18n. While we made every effort to not disrupt existing translations, there may be a few strings that are now misaligned. We have also introduced a few new strings which need translating. If you're willing to help out, please head over to our translation platform.

We appreciate any time you can give to localizing Funkwhale into your language. The more people we can reach, the more our community can grow 🐋

Let us know what you think!

The release candidate is an important opportunity for us to fix bugs before we release Funkwhale 1.3.0. If you have issues upgrading, find bugs in the software, or notice some regressions, we'd love to know!

You can post in our forum or let us know on Matrix.

Happy upgrade everyone! 🐳

By @Sporiff in Release