Skip to content

Releases: mastodon/mastodon

v4.4.1

09 Jul 15:28
Compare
Choose a tag to compare

Mastodon

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

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.

v4.4.0

08 Jul 14:13
69e1424
Compare
Choose a tag to compare

Mastodon

For a user-focused highlight of these changes, see https://blog.joinmastodon.org/2025/07/mastodon-4.4/
For changes of particular interest to application developers, see https://blog.joinmastodon.org/2025/07/mastodon-4-4-for-devs/
For a more detailed run-down on the changes, see the Changelog section below!

Upgrade overview

Tip

A hotfix release is available for this branch, please update directly to it.

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 6.2
⚠️ The minimum supported version for PostgreSQL has been bumped to 13
⚠️ The minimum supported version for Ruby has been bumped to 3.2
⚠️ The minimum supported version for Node.js has been bumped to 20
⚠️ Support for Redis namespaces has been dropped
⚠️ Requires updating the metadata for the Elasticsearch accounts index
⚠️ Rolling updates from versions earlier than Mastodon 4.3 are not supported
⚠️ Import jobs from Mastodon versions earlier than Mastodon 4.2 are not supported
⚠️ ImageMagick is being deprecated and may be removed in a future version
ℹ️ The new experimental Fediverse Auxiliary Service Providers feature requires a new fasp sidekiq queue
ℹ️ Requires streaming server restart
ℹ️ Requires database migrations

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

Changelog

Added

Read more

v4.3.9

02 Jul 12:17
Compare
Choose a tag to compare

Mastodon

Changelog

Changed

  • Change passthrough video processing to emit moov atom at start of video (#34726 by @ClearlyClaire)

Fixed

Upgrade notes

To get the code for v4.3.9, use git fetch && git checkout v4.3.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.3.0, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

  • Ruby: 3.1 or newer
  • PostgreSQL: 12 or newer. PostgreSQL versions 14.0 to 14.3 are not supported as they contain a critical data-corruption bug (see v4.3.0 release notes)
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 4 or newer
  • Node: 18 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer

Update steps

The following instructions are for updating from 4.3.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, please read the v4.3.0 release notes, as there have been multiple important changes.

Non-docker

Tip

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

  1. Install dependencies with bundle install
  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.

v4.2.22

02 Jul 12:18
Compare
Choose a tag to compare

Mastodon

Changelog

Changed

  • Change passthrough video processing to emit moov atom at start of video (#34726 by @ClearlyClaire)

Fixed

Upgrade notes

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

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

Important

Since v4.2.10, Mastodon is now performing stricter checks to prevent client IP address spoofing. This means that if one of your reverse proxy is not on Mastodon's local network, you will need to set TRUSTED_PROXY_IP accordingly, listing the IP address of every trusted reverse-proxy (including local network ones). See the documentation for more information.

Dependencies

The minimum supported Ruby version has been bumped from 3.0 to 3.1 in Mastodon v4.2.17. Otherwise, external dependencies have not changed since v4.2.4, the compatible PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

  • Ruby: 3.1 to 3.3
  • PostgreSQL: 10 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 4 or newer
  • Node: 16 or newer
  • ImageMagick: 6.9.7-7 or newer

Update steps

Tip

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

The following instructions are for updating from 4.2.21.

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 only:

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

Using Docker:

  1. Restart all Mastodon processes

v4.4.0-rc.1

01 Jul 13:23
a203a05
Compare
Choose a tag to compare
v4.4.0-rc.1 Pre-release
Pre-release

Mastodon

Warning

This is a pre-release! This has not been as widely tested as regular releases, although it is still tested on mastodon.social and some other servers. If you update to this release, you will not be able to safely downgrade to the existing stable releases. You will, however, be able to upgrade to later nightly releases or pre-releases, as well as the upcoming 4.4.0 stable release.

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 6.2
⚠️ The minimum supported version for PostgreSQL has been bumped to 13
⚠️ The minimum supported version for Ruby has been bumped to 3.2
⚠️ The minimum supported version for Node.js has been bumped to 20
⚠️ Support for Redis namespaces has been dropped
⚠️ Requires updating the metadata for the Elasticsearch accounts index
⚠️ We moved from webpack to Vite, third-party themes may need changes
⚠️ Rolling updates from versions earlier than Mastodon 4.3 are not supported
⚠️ Import jobs from Mastodon versions earlier than Mastodon 4.2 are not supported
⚠️ ImageMagick is being deprecated and may be removed in a future version
ℹ️ Requires streaming server restart
ℹ️ Requires database migrations

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

Changelog (v4.4.0-rc.1)

Security

Added

  • Add FASP account search support (#34033 by @oneiros)
  • Add Server Moderation Notes (#31529 by @ThisIsMissEm)
  • Add loading spinner to “Post” button when sending a post (#35153 by @diondiondion)
  • Add optional bulk mailer settings (#35191 and #35203 by @oneiros)
    This adds the optional environment variables BULK_SMTP_PORT, BULK_SMTP_SERVER, BULK_SMTP_LOGIN and so on analogous to SMTP_PORT, SMTP_SERVER, SMTP_LOGIN and related SMTP configuration environment variables.
    When BULK_SMTP_SERVER is set, this group of variables is used instead of the regular ones for sending announcement notification emails and Terms of Service notification emails.

Changed

  • Change results from Follow Recommendations FASP to be persisted (#35218 by @oneiros)
  • Change wording of "discard draft?" confirmation dialogs (#35192 by @diondiondion)
  • Change rule translation interface to display english name and populate empty translations (#35170 and #35174 by @ClearlyClaire)
  • Change terms of service e-mail job to be iterable (#35126 by @Gargron)
  • Change Advanced Web UI to use the new main menu instead of the “Getting started” column (#35117 by @diondiondion)

Removed

  • Remove link to terms of service generator (#35127 by @Gargron)
    The current template has been found to be unsatisfactory, and the feature will return in a future release with a better template.

Fixed

Changelog (v4.4.0-beta.2)

Added

Changed

Removed

Fixed

Changelog (v4.4.0-beta.1)

Added

Read more

v4.4.0-beta.2

17 Jun 17:34
98f9824
Compare
Choose a tag to compare
v4.4.0-beta.2 Pre-release
Pre-release

Mastodon

Warning

This is a pre-release! This has not been as widely tested as regular releases, although it is still tested on mastodon.social and some other servers. If you update to this release, you will not be able to safely downgrade to the existing stable releases. You will, however, be able to upgrade to later nightly releases or pre-releases, as well as the upcoming 4.4.0 stable release.

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 6.2
⚠️ The minimum supported version for PostgreSQL has been bumped to 13
⚠️ The minimum supported version for Ruby has been bumped to 3.2
⚠️ The minimum supported version for Node.js has been bumped to 20
⚠️ Support for Redis namespaces has been dropped
⚠️ Requires updating the metadata for the Elasticsearch accounts index
⚠️ We moved from webpack to Vite, third-party themes may need changes
⚠️ Rolling updates from versions earlier than Mastodon 4.3 are not supported
⚠️ Import jobs from Mastodon versions earlier than Mastodon 4.2 are not supported
⚠️ ImageMagick is being deprecated and may be removed in a future version
ℹ️ Requires streaming server restart
ℹ️ Requires database migrations

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

Changelog (v4.4.0-beta.2)

Added

Changed

Removed

Fixed

Changelog (v4.4.0-beta.1)

Added

Read more

v4.4.0-beta.1

04 Jun 09:48
12c0e58
Compare
Choose a tag to compare
v4.4.0-beta.1 Pre-release
Pre-release

Mastodon

Warning

This is a pre-release! This has not been as widely tested as regular releases, although it is still tested on mastodon.social and some other servers. If you update to this release, you will not be able to safely downgrade to the existing stable releases. You will, however, be able to upgrade to later nightly releases or pre-releases, as well as the upcoming 4.4.0 stable release.

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 6.2
⚠️ The minimum supported version for PostgreSQL has been bumped to 13
⚠️ The minimum supported version for Ruby has been bumped to 3.2
⚠️ The minimum supported version for Node.js has been bumped to 20
⚠️ Support for Redis namespaces has been dropped
⚠️ Requires updating the metadata for the Elasticsearch accounts index
⚠️ We moved from webpack to Vite, third-party themes may need changes
⚠️ Rolling updates from versions earlier than Mastodon 4.3 are not supported
⚠️ Import jobs from Mastodon versions earlier than Mastodon 4.2 are not supported
⚠️ ImageMagick is being deprecated and may be removed in a future version
ℹ️ Requires streaming server restart
ℹ️ Requires database migrations

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

Changelog

Added

Read more

v4.3.8

06 May 13:43
Compare
Choose a tag to compare

Mastodon

Changelog

Security

Added

Changed

  • Change activity distribution error handling to skip retrying for deleted accounts (#33617 by @ClearlyClaire)

Removed

Fixed

  • Fix incorrect redirect in response to unauthenticated API requests in limited federation mode (#34549 by @ClearlyClaire)
  • Fix sign-up e-mail confirmation page reloading on error or redirect (#34548 by @ClearlyClaire)

Upgrade notes

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

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.3.0, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

  • Ruby: 3.1 or newer
  • PostgreSQL: 12 or newer. PostgreSQL versions 14.0 to 14.3 are not supported as they contain a critical data-corruption bug (see v4.3.0 release notes)
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 4 or newer
  • Node: 18 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer

Update steps

The following instructions are for updating from 4.3.7.

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, please read the v4.3.0 release notes, as there have been multiple important changes.

Non-docker

Tip

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

  1. Install dependencies with bundle install
  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.

v4.2.21

06 May 13:34
Compare
Choose a tag to compare

Mastodon

Changelog

Security

Added

Changed

  • Change activity distribution error handling to skip retrying for deleted accounts (#33617 by @ClearlyClaire)

Removed

Fixed

  • Fix incorrect redirect in response to unauthenticated API requests in limited federation mode (#34549 by @ClearlyClaire)
  • Fix sign-up e-mail confirmation page reloading on error or redirect (#34548 by @ClearlyClaire)

Upgrade notes

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

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

Important

Since v4.2.10, Mastodon is now performing stricter checks to prevent client IP address spoofing. This means that if one of your reverse proxy is not on Mastodon's local network, you will need to set TRUSTED_PROXY_IP accordingly, listing the IP address of every trusted reverse-proxy (including local network ones). See the documentation for more information.

Dependencies

The minimum supported Ruby version has been bumped from 3.0 to 3.1 in Mastodon v4.2.17. Otherwise, external dependencies have not changed since v4.2.4, the compatible PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

  • Ruby: 3.1 to 3.3
  • PostgreSQL: 10 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 4 or newer
  • Node: 16 or newer
  • ImageMagick: 6.9.7-7 or newer

Update steps

Tip

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

The following instructions are for updating from 4.2.20.

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 only:

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

Using Docker:

  1. Restart all Mastodon processes

v4.3.7

02 Apr 12:18
6f16011
Compare
Choose a tag to compare

Mastodon

Changelog

Add

Changed

Fixed

Upgrade notes

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

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.3.0, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

  • Ruby: 3.1 or newer
  • PostgreSQL: 12 or newer. PostgreSQL versions 14.0 to 14.3 are not supported as they contain a critical data-corruption bug (see v4.3.0 release notes)
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 4 or newer
  • Node: 18 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer

Update steps

The following instructions are for updating from 4.3.6.

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, please read the v4.3.0 release notes, as there have been multiple important changes.

Non-docker

Tip

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

  1. Install dependencies with bundle install
  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.