<picture> </picture>

This is a hotfix for 4.4, mostly addressing build and deployment issues with 4.4.0.

Check out the 4.4.0 release notes for information.

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

Fixed

• Fix nearly every sub-directory being crawled as part of Vite build (#35323 by @ClearlyClaire)
• Fix assets not building when Redis is unavailable (#35321 by @oneiros)
• Fix replying from media modal or pop-in-player tagging user @undefined (#35317 by @ClearlyClaire)
• Fix support for special characters in various environment variables (#35314 by @mjankowski and @ClearlyClaire)
• Fix some database migrations failing for indexes manually removed by admins (#35309 by @mjankowski)

Upgrade notes

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

[!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.4.0:

• Ruby: 3.2 or newer
• PostgreSQL: 13 or newer
• Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
• LibreTranslate (optional, for translations): 1.3.3 or newer
• Redis: 6.2 or newer
• Node: 20 or newer
• libvips (optional, instead of ImageMagick): 8.13 or newer
• ImageMagick (optional if using libvips): 6.9.7-7 or newer

Update steps

The following instructions are for updating from 4.4.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. In particular, it is very important to read the 4.4.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. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
2. Restart all Mastodon processes.

When using Docker

1. Restart all Mastodon processes.