3.2 KiB

Czysty Wina Historia

Upgrade your Docker Funkwhale installation

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

Upgrade Funkwhale

SSH into your server
Log in as your funkwhale user.
```
su funkwhale
```
Navigate to your Funkwhale directory.
```
cd /srv/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`
```
Change the version number in your .env file. Update this to the same version number you exported in step 4.
```
nano .env
```
Load the configuration from your .env file.
```
source .env
```
Pull the updated containers.
```
docker-compose pull
```

Apply the database migrations.

docker-compose run --rm api python manage.py migrate

Relaunch your containers.
```
docker-compose up -d
```

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

Upgrade the postgres container

Funkwhale depends on postgres for its database container. To upgrade postgres, you need to export your database and import it into the new container.

To upgrade postgres on Docker we use the postgres-upgrade container. This Docker container automates the process of upgrading between major versions of postgres. Use these commands to upgrade your postgres container:

Export your current postgres version number. You can find this in your docker-compose.yml file.
```
export OLD_POSTGRES=13
```
Export the major version number you want to upgrade to.
```
export NEW_POSTGRES=14
```
Stop the postgres container. This means no data changes while you are upgrading.
```
docker-compose stop postgres
```

Run the migration using the postgres-upgrade container. This creates a new version of the database in the /srv/funkwhale/data/postgres-new directory.

docker run --rm \
-v $(pwd)/data/postgres:/var/lib/postgresql/${OLD_POSTGRES}/data \
-v $(pwd)/data/postgres-new:/var/lib/postgresql/${NEW_POSTGRES}/data \
tianon/postgres-upgrade:${OLD_POSTGRES}-to-${NEW_POSTGRES}

Re-add the access control rules required by Funkwhale.

echo "host all all all trust" | sudo tee -a ./data/postgres-new/pg_hba.conf

Swap your old database out with your new database.

mv ./data/postgres ./data/postgres-old
mv ./data/postgres-new ./data/postgres

Pull the new postgres version.
```
docker-compose pull
```
Restart your containers.
```
docker-compose up -d
```

That's it! Your Funkwhale pod is now running the new version of postgres. The old database is available in /srv/funkwhale/data/postgres-old. You can back this up and remove it from your server once you've confirmed everything is working.

3.2 KiB Czysty Wina Historia Unescape Escape

Upgrade your Docker Funkwhale installation

Upgrade Funkwhale

Upgrade the postgres container

3.2 KiB

Czysty Wina Historia