:warning: Mastodon v3.3.2 and v3.4.6 will be released on Thursday, February 3rd, between 13:00 and 15:00 UTC, fixing a variety of bugs, including a critical security issue.

To make applying the fixes easier, you can prepare by updating to Mastodon v3.4.5 (or v3.3.1), as migrating from this bugfix release will require no dependency update, no database migration and no assets compilation.

Changelog

Added

• Add more advanced migration tests (ClearlyClaire)
• Add github workflow to build Docker images (unasuke, Gargron, Gargron)

Fixed

• Fix some old migrations failing when skipping releases (ClearlyClaire)
• Fix migrations script failing in certain edge cases (ClearlyClaire)
• Fix Docker build (tribela)
• Fix Ruby 3.0 dependencies (ClearlyClaire)
• Fix followers synchronization mechanism (ClearlyClaire)

Upgrade notes

Because this is a backport, it is not available with git pull. Use git fetch && git checkout v3.4.5

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

Dependencies

External dependencies have not changed compared to v3.4.4, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

• Ruby: 2.6 to 3.1
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 5.x, 6.x or 7.x
• Redis: 4 or newer
• Node: 12 or higher

Update steps

The following instructions are for updating from 3.4.4.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker

1. Pull the code: git fetch && git checkout v3.4.5
2. Install Ruby dependencies: bundle install
3. Restart mastodon-web and mastodon-sidekiq: systemctl reload mastodon-web systemctl restart mastodon-sidekiq

Docker

The exact steps depend on your setup, but they are likely to match the following:

1. Pull the code: git fetch && git checkout v3.4.5
2. Pull the prebuilt images: docker-compose pull, or, alternatively, build them yourself: docker-compose build --pull
3. Restart all Mastodon processes: docker-compose up -d