<picture> </picture>

Upgrade overview

This release contains upgrade notes that deviate from the norm:

ℹ️ Requires assets recompilation

For more information, view the complete release notes and scroll down to the upgrade instructions section.

Changelog

Security

• Update dependencies

Added

• Add logging of account data removal (#40572 by @ClearlyClaire)

Changed

• Change account self-deletion page to always ask to confirm username (#40576 and [#40733] by @ClearlyClaire)

Fixed

• Fix threads leak by updating dependency aws-sdk-s3
• Fix inconsistent horizontal page padding between profile and profile editor (#40700 by @diondiondion)
• Fix server error on registration for wrong DOB (#40607 by @sudeeptarlekar)
• Fix quotes disclaimer disappearing on posts with no quote (#40587 by @crafkaz)
• Fix POST /api/v1/accounts still being accessible when SSO_ACCOUNT_SIGN_UP is set (#40681 by @ClearlyClaire)
• Fix reported statuses not being deleted after account deletion (#40650 by @ClearlyClaire)
• Fix mobile navigation covering up "Next step" button during onboarding (#40634 by @diondiondion)
• Fix rate limits not normalizing submitted e-mail addresses (#40658 by @Gargron)
• Fix moderators being able to issue a warning on moderators of higher position (#40646 by @ClearlyClaire)
• Fix description text overflowing on Overview landing page (#40272 by @diondiondion)
• Fix account avatar and header descriptions not being deleted when an account is deleted (#40621 by @ClearlyClaire)
• Fix deleted accounts not being removed from featured collections (#40623 by @ClearlyClaire)
• Fix PreviewCardsStatus records not being deleted on account deletion (#40624 by @ClearlyClaire)
• Fix replies order (#40481 by @OmmyZhang)
• Fix missing confirmation when leaving with an unsent post (#40478 by @crafkaz)

Upgrade notes

To get the code for v4.6.9, use git fetch && git checkout v4.6.9.

[!NOTE] 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 since v4.6.0.

• Ruby: 3.3 or newer
• PostgreSQL: 14 or newer
• Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
• LibreTranslate (optional, for translations): 1.3.3 or newer
• Redis: 7.0 or newer
• Node: 22 or newer
• libvips: 8.13 or newer
• FFMpeg: 5.1 or newer

Update steps

The following instructions are for updating from 4.6.8.

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. In particular, it is very important to read the 4.6.0 release notes.

Non-Docker

[!TIP] The charlock_holmes gem may fail to build on some systems with recent versions of gcc. If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

1. Install dependencies with bundle install and yarn install --immutable
2. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
3. Restart all Mastodon processes.

When using Docker

1. Restart all Mastodon processes.