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.
- Upgrade your
docker-compose.ymlfile. 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 "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/${FUNKWHALE_VERSION}/deploy/docker-compose.yml"
- The new Docker containers include Nginx files that read settings from your
.envfile. If you want to override these, uncomment the mounted files in thedocker-compose.ymlfile and point them to your custom templates. -
Recommended: Docker suggests using the
composeplugin over the standalonedocker-composescript. We've updated our instructions to reflect this. To migrate to the new setup:- Download the Docker compose plugin
- Stop your containers using the docker-compose syntax.
sh sudo docker-compose down- Bring the containers back up using the docker compose syntax.
sh sudo docker compose up -dNon-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 manage.py script. All manage.py commands can now be run using the funkwhale-manage entrypoint. For example:
sh
venv/bin/python manage.py import_files
Becomes
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! 🐳