: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.3.1 (or v3.4.5), as migrating from this bugfix release will require no dependency update, no database migration and no assets compilation.

Upgrade overview

This release contains upgrade notes that deviate from the norm:

:warning: A new system dependency is required: shared-mime-info

For more information, scroll down to the upgrade notes section.

Changelog

See the full changelog at https://github.com/mastodon/mastodon/blob/v3.3.1/CHANGELOG.md

Fixed

• Update some dependencies that were broken or unavailable
• Fix some old migrations failing when skipping releases
• Fix many other bugs and performance issues

Security

• Fix user notes not having a length limit (ClearlyClaire)
• Fix revoking a specific session not working (ClearlyClaire)
• Fix filtering DMs from non-followed users (ClearlyClaire)

Upgrade notes

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

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

A new system dependency is required: shared-mime-info, which is likely already installed on your system. On Debian-based systems, it can be installed using apt install shared-mime-info.

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

• Ruby: 2.6 to 2.7
• PostgreSQL: 9.4 or newer
• Elasticsearch (optional, for full-text search): 5.x, 6.x or 7.x
• Redis: 4 or newer
• Node:
  • Node 10: 10.0 or newer
  • Node 12: 12.16 or newer
  • Node 13: 13.9 or newer
  • Node 14: 14.5 or newer

Update steps

The following instructions are for updating from 3.3.0.

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. Install new system dependencies (as root): apt install shared-mime-info
2. Pull the code: git fetch && git checkout v3.3.1
3. Install Ruby dependencies: bundle install
4. 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.3.1
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