v4.5.7

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

• Reject unconfirmed FASPs (#37926 by @oneiros, GHSA-qgmm-vr4c-ggjg)
• Re-use custom socket class for FASP requests (#37925 by @oneiros, GHSA-46w6-g98f-wxqm)

Added

• Add --suspended-only option to tootctl emoji purge (#37828 and #37861 by @ClearlyClaire and @mjankowski)

Fixed

• Fix emoji data not being properly cached (#37858 by @ChaosExAnima)
• Fix delete & redraft of pending posts (#37839 by @ClearlyClaire)
• Fix processing separate key documents without the ActivityStreams context (#37826 by @ClearlyClaire)
• Fix custom emojis not being purged on domain suspension (#37808 by @ClearlyClaire)
• Fix users without special permissions being able to stream disabled timelines (#37791 by @ClearlyClaire)
• Fix processing of object updates with duplicate hashtags (#37756 by @ClearlyClaire)

Upgrade notes

To get the code for v4.5.7, use git fetch && git checkout v4.5.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.5.0.

• Ruby: 3.2 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: 20.19 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.5.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, it is very important to read the 4.5.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.14

Note

While we continue to support Mastodon 4.4 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Security

• Reject unconfirmed FASPs (#37926 by @oneiros, GHSA-qgmm-vr4c-ggjg)
• Re-use custom socket class for FASP requests (#37925 by @oneiros, GHSA-46w6-g98f-wxqm)

Added

• Add --suspended-only option to tootctl emoji purge (#37828 and #37861 by @ClearlyClaire and @mjankowski)

Fixed

• Fix custom emojis not being purged on domain suspension (#37808 by @ClearlyClaire)
• Fix processing of object updates with duplicate hashtags (#37756 by @ClearlyClaire)

Upgrade notes

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

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.1:

• 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.13.

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

1. Restart all Mastodon processes.

When using Docker

1. Restart all Mastodon processes.

v4.3.20

Note

While we continue to support Mastodon 4.3 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Added

• Add --suspended-only option to tootctl emoji purge (#37828 and #37861 by @ClearlyClaire and @mjankowski)

Fixed

• Fix processing of object updates with duplicate hashtags (#37756 by @ClearlyClaire)

Upgrade notes

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

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.19.

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. Restart all Mastodon processes.

When using docker

1. Restart all Mastodon processes.

v4.5.6

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

• Fix ActivityPub collection caching logic for pinned posts and featured tags not checking blocked accounts (GHSA-ccpr-m53r-mfwr)

Changed

• Shorten caching of quote posts pending approval (#37570 and #37592 by @ClearlyClaire)

Fixed

• Fix relationship cache not being cleared when handling account migrations (#37664 by @ClearlyClaire)
• Fix quote cancel button not appearing after edit then delete-and-redraft (#37066 by @PGrayCS)
• Fix followers with profile subscription (bell icon) being notified of post edits (#37646 by @ClearlyClaire)
• Fix error when encountering invalid tag in updated object (#37635 by @ClearlyClaire)
• Fix cross-server conversation tracking (#37559 by @ClearlyClaire)
• Fix recycled connections not being immediately closed (#37335 and #37674 by @ClearlyClaire and @shleeable)

Upgrade notes

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

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.5.0.

• Ruby: 3.2 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: 20.19 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.5.5.

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.5.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.13

Note

While we continue to support Mastodon 4.4 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Security

• Fix ActivityPub collection caching logic for pinned posts and featured tags not checking blocked accounts (GHSA-ccpr-m53r-mfwr)

Fixed

• Fix relationship cache not being cleared when handling account migrations (#37664 by @ClearlyClaire)
• Fix error when encountering invalid tag in updated object (#37635 by @ClearlyClaire)
• Fix recycled connections not being immediately closed (#37335 and #37674 by @ClearlyClaire and @shleeable)

Upgrade notes

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

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.1:

• 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.12.

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

1. Restart all Mastodon processes.

When using Docker

1. Restart all Mastodon processes.

v4.3.19

Note

While we continue to support Mastodon 4.3 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Security

• Fix ActivityPub collection caching logic for pinned posts and featured tags not checking blocked accounts (GHSA-ccpr-m53r-mfwr)

Fixed

• Fix relationship cache not being cleared when handling account migrations (#37664 by @ClearlyClaire)
• Fix error when encountering invalid tag in updated object (#37635 by @ClearlyClaire)
• Fix recycled connections not being immediately closed (#37335 and #37674 by @ClearlyClaire and @shleeable)

Upgrade notes

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

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.18.

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. Restart all Mastodon processes.

When using docker

1. Restart all Mastodon processes.

v4.5.5

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

• Fix missing limits on various federated properties GHSA-gg8q-rcg7-p79g
• Fix remote user suspension bypass GHSA-5h2f-wg8j-xqwp
• Fix missing length limits on some user-provided fields GHSA-6x3w-9g92-gvf3
• Fix missing access check for push notification settings update GHSA-f3q8-7vw3-69v4

Changed

• Skip tombstone creation on deleting from 404 (#37533 by @ClearlyClaire)

Fixed

• Fix potential duplicate handling of quote accept/reject/delete (#37537 by @ClearlyClaire)
• Fix FeedManager#filter_from_home error when handling a reblog of a deleted status (#37486 by @ClearlyClaire)
• Fix needlessly complicated SQL query in status batch removal (#37469 by @ClearlyClaire)
• Fix quote_approval_policy being reset to user defaults when omitted in status update (#37436 and #37474 by @mjankowski and @shleeable)
• Fix Vary parsing in cache control enforcement (#37426 by @MegaManSec)
• Fix missing URI scheme test in QuoteRequest handling (#37425 by @MegaManSec)
• Fix thread-unsafe ActivityPub activity dispatch (#37423 by @MegaManSec)
• Fix URI generation for reblogs by accounts with numerical ActivityPub identifiers (#37415 by @oneiros)
• Fix SignatureParser accepting duplicate parameters in HTTP Signature header (#37375 by @shleeable)
• Fix emoji with variant selector not being rendered properly (#37320 by @ChaosExAnima)
• Fix mobile admin sidebar displaying under batch table toolbar (#37307 by @diondiondion)

Upgrade notes

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

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.5.0.

• Ruby: 3.2 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: 20.19 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.5.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. In particular, it is very important to read the 4.5.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.12

Note

While we continue to support Mastodon 4.4 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Security

• Fix missing limits on various federated properties GHSA-gg8q-rcg7-p79g
• Fix remote user suspension bypass GHSA-5h2f-wg8j-xqwp
• Fix missing length limits on some user-provided fields GHSA-6x3w-9g92-gvf3
• Fix missing access check for push notification settings update GHSA-f3q8-7vw3-69v4

Changed

• Skip tombstone creation on deleting from 404 (#37533 by @ClearlyClaire)

Fixed

• Fix potential duplicate handling of quote accept/reject/delete (#37537 by @ClearlyClaire)
• Fix FeedManager#filter_from_home error when handling a reblog of a deleted status (#37486 by @ClearlyClaire)
• Fix needlessly complicated SQL query in status batch removal (#37469 by @ClearlyClaire)
• Fix Vary parsing in cache control enforcement (#37426 by @MegaManSec)
• Fix thread-unsafe ActivityPub activity dispatch (#37423 by @MegaManSec)
• Fix SignatureParser accepting duplicate parameters in HTTP Signature header (#37375 by @shleeable)

Upgrade notes

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

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.1:

• 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.11.

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

1. Restart all Mastodon processes.

When using Docker

1. Restart all Mastodon processes.

v4.3.18

Note

While we continue to support Mastodon 4.3 and release patches for it, please note that Mastodon 4.5 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.5 version when they can.

Changelog

Security

• Fix missing limits on various federated properties GHSA-gg8q-rcg7-p79g
• Fix remote user suspension bypass GHSA-5h2f-wg8j-xqwp
• Fix missing length limits on some user-provided fields GHSA-6x3w-9g92-gvf3
• Fix missing access check for push notification settings update GHSA-f3q8-7vw3-69v4

Fixed

• Fix FeedManager#filter_from_home error when handling a reblog of a deleted status (#37486 by @ClearlyClaire)
• Fix needlessly complicated SQL query in status batch removal (#37469 by @ClearlyClaire)
• Fix Vary parsing in cache control enforcement (#37426 by @MegaManSec)
• Fix thread-unsafe ActivityPub activity dispatch (#37423 by @MegaManSec)
• Fix SignatureParser accepting duplicate parameters in HTTP Signature header (#37375 by @shleeable)

Upgrade notes

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

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.17.

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. Restart all Mastodon processes.

When using docker

1. Restart all Mastodon processes.

v4.5.4

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

• Fix SSRF protection bypass (GHSA)
• Fix missing ownership check in severed relationships controller (GHSA)

Changed

• Change HTTP Signature verification status from 401 to 503 on temporary failure to get remote actor (#37221 by @ClearlyClaire)

Fixed

• Fix custom emojis not being rendered in profile fields (#37365 by @ClearlyClaire)
• Fix serialization of context pages (#37376 by @ClearlyClaire)
• Fix quotes with CWs but no text not having fallback link (#37361 by @ClearlyClaire)
• Fix outdated link target for “locked” warning (#37366 by @ClearlyClaire)
• Fix local custom emojis sometimes being rendered in remote posts (#37284 by @ChaosExAnima)
• Fix some assets not being loaded from configured CDN (#37310 by @ChaosExAnima)
• Fix notifications page error in Tor browser (#37285 by @diondiondion)
• Fix custom emojis not being displayed in CWs and fav/boost notifications (#37272 and #37306 by @ChaosExAnima and @ClearlyClaire)
• Fix default Admin role not including view_feeds permission (#37301 by @ClearlyClaire)
• Fix hashtag autocomplete replacing suggestion's first characters with input (#37281 by @ClearlyClaire)
• Fix mentions of domain-blocked users being processed (#37257 by @ClearlyClaire)

Upgrade notes

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

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.5.0.

• Ruby: 3.2 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: 20.19 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.5.3.

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.5.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.