Upgrading your funkwhale instance to a newer version

Note

Before upgrading your instance, we strongly advise you to make at least a database backup. Ideally, you should make a full backup, including the database and the media files.

We’re commited to make upgrade as easy and straightforward as possible, however, funkwhale is still in development and you’ll be safer with a backup.

Reading the release notes

Please take a few minutes to read the Changelog: updates should work similarly from version to version, but some of them may require additional steps. Those steps would be described in the version release notes.

Docker setup

If you’ve followed the setup instructions in Docker, upgrade path is easy:

cd /srv/funkwhale
# hardcode the targeted version your env file
# (look for the FUNKWHALE_VERSION variable)
nano .env
# Pull the new version containers
docker-compose pull
# Apply the database migrations
docker-compose run --rm api python manage.py migrate
# Relaunch the containers
docker-compose up -d

Non-docker setup

Upgrade the static files

On non-docker setups, the front-end app is updated separately from the API. This is as simple as downloading the zip with the static files and extracting it in the correct place.

The following example assume your setup match Frontend setup.

# this assumes you want to upgrade to version "0.13"
export FUNKWHALE_VERSION="0.13"
cd /srv/funkwhale
curl -L -o front.zip "https://code.eliotberriot.com/funkwhale/funkwhale/builds/artifacts/$FUNKWHALE_VERSION/download?job=build_front"
unzip -o front.zip
rm front.zip

Upgrading the API

On non-docker, upgrade involves a few more commands. We assume your setup match what is described in debian:

# stop the services
sudo systemctl stop funkwhale.target

# this assumes you want to upgrade to version "0.13"
export FUNKWALE_VERSION="0.13"
cd /srv/funkwhale

# download more recent API files
curl -L -o "api-0.13.zip" "https://code.eliotberriot.com/funkwhale/funkwhale/-/jobs/artifacts/$FUNKWALE_VERSION/download?job=build_api"
unzip "api-$FUNKWALE_VERSION.zip" -d extracted
rm -rf api/ && mv extracted/api .
rm -rf extracted

# update os dependencies
sudo api/install_os_dependencies.sh install
# update python dependencies
source /srv/funkwhale/load_env
source /srv/funkwhale/virtualenv/bin/activate
pip install -r api/requirements.txt

# apply database migrations
python api/manage.py migrate
# collect static files
python api/manage.py collectstatic --no-input

# restart the services
sudo systemctl restart funkwhale.target