v4.5.2-ls170

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.1-ls169...v4.5.2-ls170

Remote Changes:

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

Changed

• Change private quote education modal to not show up on self-quotes (#36926 by @ClearlyClaire)

Fixed

• Fix missing fallback link in CW-only quote posts (#36963 by @ClearlyClaire)
• Fix statuses without text being hidden while loading (#36962 by @ClearlyClaire)
• Fix g + h keyboard shortcut not working when a post is focused (#36935 by @diondiondion)
• Fix quoting overwriting current content warning (#36934 by @ClearlyClaire)
• Fix scroll-to-status in threaded view being unreliable (#36927 by @ClearlyClaire)
• Fix path resolution for emoji worker (#36897 by @ChaosExAnima)
• Fix tootctl upgrade storage-schema failing with ArgumentError (#36914 by @shugo)
• Fix cross-origin handling of CSS modules (#36890 by @ClearlyClaire)
• Fix error with remote tags including percent signs (#36886 and #36925 by @ChaosExAnima and @ClearlyClaire)
• Fix bogus quote approval policy not always being replaced correctly (#36885 by @ClearlyClaire)
• Fix hashtag completion not being inserted correctly (#36884 by @ClearlyClaire)
• Fix Cmd/Ctrl + Enter in the composer triggering confirmation dialog action (#36870 by @diondiondion)

Upgrade notes

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

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

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

v4.5.1-ls169

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.0-ls168...v4.5.1-ls169

Remote Changes:

This is a patch release for 4.5.

Check out the 4.5.0 release notes for information.

Changelog

Fixes

• Fix Cmd/Ctrl + Enter not submitting Alt text modal on some browsers (#36866 by @diondiondion)
• Fix posts coming from public/hashtag streaming being marked as unquotable (#36860 and #36869 by @ClearlyClaire)
• Fix old previously-undiscovered posts being treated as new when receiving an Update (#36848 by @ClearlyClaire)
• Fix blank screen in browsers that don't support Intl.DisplayNames (#36847 by @diondiondion)
• Fix filters not being applied to quotes in detailed view (#36843 by @ClearlyClaire)
• Fix scroll shift caused by fetch-all-replies alerts (#36807 by @diondiondion)
• Fix dropdown menu not focusing first item when opened via keyboard (#36804 by @diondiondion)
• Fix assets build issue on arch64 (#36781 by @ClearlyClaire)
• Fix /api/v1/statuses/:id/context sometimes returing Mastodon-Async-Refresh without result_count (#36779 by @ClearlyClaire)
• Fix prepared quote not being discarded with contents when replying (#36778 by @ClearlyClaire)

Upgrade notes

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

glitch-v4.5.2-ls309

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.1-ls308...glitch-v4.5.2-ls309

Remote Changes:

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

Changed

• (glitch-soc) Change quotes to inherit local-only status of quoted post in composer (#3286)
• Change private quote education modal to not show up on self-quotes (#36926 by @ClearlyClaire)

Fixed

• (glitch-soc) Fix d bookmark keyboard shortcut (#3285)
• (glitch-soc) Fix threaded mode not resetting quote (#3284)
• Fix missing fallback link in CW-only quote posts (#36963 by @ClearlyClaire)
• Fix statuses without text being hidden while loading (#36962 by @ClearlyClaire)
• Fix g + h keyboard shortcut not working when a post is focused (#36935 by @diondiondion)
• Fix quoting overwriting current content warning (#36934 by @ClearlyClaire)
• Fix scroll-to-status in threaded view being unreliable (#36927 by @ClearlyClaire)
• Fix path resolution for emoji worker (#36897 by @ChaosExAnima)
• Fix tootctl upgrade storage-schema failing with ArgumentError (#36914 by @shugo)
• Fix cross-origin handling of CSS modules (#36890 by @ClearlyClaire)
• Fix error with remote tags including percent signs (#36886 and #36925 by @ChaosExAnima and @ClearlyClaire)
• Fix bogus quote approval policy not always being replaced correctly (#36885 by @ClearlyClaire)
• Fix hashtag completion not being inserted correctly (#36884 by @ClearlyClaire)
• Fix Cmd/Ctrl + Enter in the composer triggering confirmation dialog action (#36870 by @diondiondion)

Upgrade notes

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

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

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

glitch-v4.5.1-ls308

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.0-ls307...glitch-v4.5.1-ls308

Remote Changes:

This is a patch release for 4.5.

Check out the 4.5.0 release notes for information.

Changelog

Fixes

• Fix Cmd/Ctrl + Enter not submitting Alt text modal on some browsers (#36866 by @diondiondion)
• Fix posts coming from public/hashtag streaming being marked as unquotable (#36860 and #36869 by @ClearlyClaire)
• Fix old previously-undiscovered posts being treated as new when receiving an Update (#36848 by @ClearlyClaire)
• Fix blank screen in browsers that don't support Intl.DisplayNames (#36847 by @diondiondion)
• Fix filters not being applied to quotes in detailed view (#36843 by @ClearlyClaire)
• Fix scroll shift caused by fetch-all-replies alerts (#36807 by @diondiondion)
• Fix dropdown menu not focusing first item when opened via keyboard (#36804 by @diondiondion)
• Fix assets build issue on arch64 (#36781 by @ClearlyClaire)
• Fix /api/v1/statuses/:id/context sometimes returing Mastodon-Async-Refresh without result_count (#36779 by @ClearlyClaire)
• Fix prepared quote not being discarded with contents when replying (#36778 by @ClearlyClaire)

Upgrade notes

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

develop-v4.5.0-rc.3-ls129

CI Report:

N/A

LinuxServer Changes:

Full Changelog: develop-v4.5.0-rc.3-ls128...develop-v4.5.0-rc.3-ls129

Remote Changes:

Data change at JSON endpoint https://api.github.com/repos/mastodon/mastodon/releases

v4.5.1-ls168

CI Report:

N/A

LinuxServer Changes:

No changes

Remote Changes:

This is a patch release for 4.5.

Check out the 4.5.0 release notes for information.

Changelog

Fixes

• Fix Cmd/Ctrl + Enter not submitting Alt text modal on some browsers (#36866 by @diondiondion)
• Fix posts coming from public/hashtag streaming being marked as unquotable (#36860 and #36869 by @ClearlyClaire)
• Fix old previously-undiscovered posts being treated as new when receiving an Update (#36848 by @ClearlyClaire)
• Fix blank screen in browsers that don't support Intl.DisplayNames (#36847 by @diondiondion)
• Fix filters not being applied to quotes in detailed view (#36843 by @ClearlyClaire)
• Fix scroll shift caused by fetch-all-replies alerts (#36807 by @diondiondion)
• Fix dropdown menu not focusing first item when opened via keyboard (#36804 by @diondiondion)
• Fix assets build issue on arch64 (#36781 by @ClearlyClaire)
• Fix /api/v1/statuses/:id/context sometimes returing Mastodon-Async-Refresh without result_count (#36779 by @ClearlyClaire)
• Fix prepared quote not being discarded with contents when replying (#36778 by @ClearlyClaire)

Upgrade notes

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

v4.5.0-ls168

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.0-ls167...v4.5.0-ls168

Remote Changes:

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

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 7.0
⚠️ The minimum supported version for PostgreSQL has been bumped to PostgreSQL 14
⚠️ 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
ℹ️ Sidekiq has been updated, which may require you to change health check or monitoring code
ℹ️ 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

• Add support for allowing and authoring quotes (#35355, #35578, #35614, #35618, #35624, #35626, #35652, #35629, #35665, #35653, #35670, #35677, #35690, #35697, #35689, #35699, #35700, #35701, #35709, #35714, #35713, #35715, #35725, #35749, #35769, #35780, #35762, #35804, #35808, #35805, #35819, #35824, #35828, #35822, #35835, #35865, #35860, #35832, #35891, #35894, #35895, #35820, #35917, #35924, #35925, #35914, #35930, #35941, #35939, #35948, #35955, #35967, #35990, #35991, #35975, #35971, #36002, #35986, #36031, #36034, #36038, #36054, #36052, #36055, #36065, #36068, #36083, #36087, #36080, #36091, #36090, #36118, #36119, #36128, #36094, #36129, #36138, #36132, #36151, #36158, #36171, #36194, #36220, #36169, #36130, #36249, #36153, #36299, #36291, #36301, #36315, #36317, #36364, #36383, #36381, #36459, #36464, #36461, #36516, #36528, #36549, #36550, #36559, #36693, #36704, #36690, #36689, #36696, #36721, #36695 and #36736 by @ChaosExAnima, @ClearlyClaire, @Lycolia, @diondiondion, and @tribela)
  This includes a revamp of the composer interface.
  See https://blog.joinmastodon.org/2025/09/introducing-quote-posts/ for a user-centric overview of the feature, and https://docs.joinmastodon.org/client/quotes/ for API documentation.
• Add support for fetching and refreshing replies to the web UI (#35210, #35496, #35575, #35500, #35577, #35602, #35603, #35654, #36141, #36237, #36172, #36256, #36271, #36334, #36382, #36239, #36484, #36481, #36583, #36627 and #36547 by @ClearlyClaire, @diondiondion, @Gargron and @renchap)
• Add ability to block words in usernames (#35407, #35655, and #35806 by @ClearlyClaire and @Gargron)
• Add ability to individually disable local or remote feeds for visitors or logged-in users disabled value to server setting for live and topic feeds, as well as user permission to bypass that (#36338, #36467, #36497, #36563, #36577, #36585, #36607 and #36703 by @ClearlyClaire)
  This splits the timeline_preview setting into four more granular settings controlling live feeds and topic (hashtag, trending link) feeds.
  The setting for local topic feeds has 2 values: public and authenticated. Every other setting has 3 values: public, authenticated, disabled.
  When disabled, users with the “View live and topic feeds” will still be able to view them.
• Add support for displaying of quote posts in Moderator UI (#35964 by @ThisIsMissEm)
• Add support for displaying link previews for Admin UI (#35958 by @ThisIsMissEm)
• Add a new server setting to choose the server landing page (#36588 and #36602 by @ClearlyClaire and @renchap)
• Add support for Update activities on converted object types (#36322 by @ClearlyClaire)
• Add support for dynamic viewport height (#36272 by @e1berd)
• Add support for numeric-based URIs for new local accounts (#32724, #36304, #36316, and #36365 by @ClearlyClaire)
• Add default visualizer for audio upload without poster (#36734 by @ChaosExAnima)
• Add Traditional Mongolian to posting languages (#36196 by @shimon1024)
• Add example post with manual quote approval policy to dev:populate_sample_data (#36099 by @ClearlyClaire)
• Add server-side support for handling posts with a quote policy allowing followers to quote (#36093 and #36127 by @ClearlyClaire)
• Add schema.org markup to SEO-enabled posts (#36075 by @Gargron)
• Add migration to fill unset default quote policy based on default post privacy (#36041 by @ClearlyClaire)
• Add “Posting defaults” setting page, moving existing settings from “Other” (#35896, #36033, #35966, #35969, and #36084 by @ClearlyClaire and @diondiondion)
• Added emoji from Twemoji v16 (#36501 and #36530 by @ChaosExAnima)
• Add feature to select custom emoji rendering (#35229, #35282, #35253, #35424, #35473, #35483, #35505, #35568, #35605, #35659, #35664, #35739, #35985, #36051, #36071, #36137, #36165, #36248, #36262, #36275, #36293, #36341, #36342, #36366, #36377, #36378, #36385, #36393, #36397, #36403, #36413, #36410, #36454, #36402, #36503, #36502, #36532, #36603, #36409, #36638 and #36750 by @ChaosExAnima, @ClearlyClaire and @braddunbar)
  This also completely reworks the processing and rendering of emojis and server-rendered HTML in statuses and other places.
• Add support for exposing conversation context for new public conversations according to FEP-7888 (#35959 and #36064 by @ClearlyClaire and @jesseplusplus)
• Add digest re-check before removing followers in synchronization mechanism (#34273 by @ClearlyClaire)
• Add support for displaying Valkey version on admin dashboard (#35785 by @ykzts)
• Add delivery failure tracking and handling to FASP jobs (#35625, #35628, and #35723 by @oneiros)
• Add example of quote post with a preview card to development sample data (#35616 by @ClearlyClaire)
• Add second set of blocked text that applies to accounts regardless of account age for spam-blocking (#35563 by @ClearlyClaire)

Changed

• Change confirmation dialogs for follow button actions “unfollow”, “unblock”, and “withdraw request” (#36289 by @diondiondion)
• Change “Follow” button labels (#36264 by @diondiondion)
• Change appearance settings to introduce new Advanced settings section (#36496 and #36506 by @diondiondion)
• Change display of blocked and muted quoted users (#36619 by @ClearlyClaire)
  This adds blocked_account, blocked_domain and muted_account values to the state attribute of Quote and ShallowQuote REST API entities.
• Change submitting an empty post to show an error rather than failing silently (#36650 by @diondiondion)
• Change "Privacy and reach" settings from "Public profile" to their own top-level category (#27294 by @ChaelCodes)
• Change number of times quote verification is retried to better deal with temporary failures (#36698 by @ClearlyClaire)
• Change display of content warnings in Admin UI (#35935 by @ThisIsMissEm)
• Change styling of column banners (#36531 by @ClearlyClaire)
• Change recommended Node version to 24 (LTS) (#36539 by @renchap)
• Change min. characters required for logged-out account search from 5 to 3 (#36487 by @Gargron)
• Change browser target to Vite legacy plugin defaults (#36611 by @larouxn)
• Change index on follows table to improve performance of some queries (#36374 by @ClearlyClaire)
• Change links to accounts in settings and moderation views to link to local view unless account is suspended (#36340 by @diondiondion)
• Change redirection for denied registration from web app to sign-in page with error message (#36384 by @ClearlyClaire)
• Change support for RFC9421 HTTP signatures to be enabled unconditionally (#36610 by @oneiros)
• Change wording and design of interaction dialog to simplify it (#36124 by @diondiondion)
• Change dropdown menus to allow disabled items to be focused (#36078 by @diondiondion)
• Change modal background colours in light mode (#36069 by @diondiondion)
• Change “Posting defaults” settings page to enforce nobody quote policy for private default visibility (#36040 by @ClearlyClaire)
• Change description of “Quiet public” (#36032 by @ClearlyClaire)
• Change “Boost with original visibility” to “Share again with your followers” (#36035 by @ClearlyClaire)
• Change handling of push subscriptions to automatically delete invalid ones on delivery (#35987 by @ThisIsMissEm)
• Change design of quote posts in web UI (#35584 and #35834 by @Gargron)
• Change auditable accounts to be sorted by username in admin action logs interface (#35272 by @breadtk)
• Change order of translation restoration and service credit on post card (#33619 by @colindean)
• Change position of ‘add more’ to be inside table toolbar on reports (#35963 by @ThisIsMissEm)
• Change docker-compose.yml sidekiq health check to work for both 4.4 and 4.5 (#36498 by @ClearlyClaire)

Fixed

• Fix relationship not being fetched to evaluate whether to show a quote post (#36517 by @ClearlyClaire)
• Fix rendering of poll options in status history modal (#35633 by @ThisIsMissEm)
• Fix “mute” button being displayed to unauthenticated visitors in hashtag dropdown (#36353 by @mkljczk)
• Fix initially selected language in Rules panel, hide selector when no alternative translations exist (#36672 by @diondiondion)
• Fix URL comparison for mentions in case of empty path (#36613 and #36626 by @ClearlyClaire)
• Fix hashtags not being picked up when full-width hash sign is used (#36103 and #36625 by @clea...

glitch-v4.5.1-ls307

CI Report:

N/A

LinuxServer Changes:

No changes

Remote Changes:

This is a patch release for 4.5.

Check out the 4.5.0 release notes for information.

Changelog

Fixes

• Fix Cmd/Ctrl + Enter not submitting Alt text modal on some browsers (#36866 by @diondiondion)
• Fix posts coming from public/hashtag streaming being marked as unquotable (#36860 and #36869 by @ClearlyClaire)
• Fix old previously-undiscovered posts being treated as new when receiving an Update (#36848 by @ClearlyClaire)
• Fix blank screen in browsers that don't support Intl.DisplayNames (#36847 by @diondiondion)
• Fix filters not being applied to quotes in detailed view (#36843 by @ClearlyClaire)
• Fix scroll shift caused by fetch-all-replies alerts (#36807 by @diondiondion)
• Fix dropdown menu not focusing first item when opened via keyboard (#36804 by @diondiondion)
• Fix assets build issue on arch64 (#36781 by @ClearlyClaire)
• Fix /api/v1/statuses/:id/context sometimes returing Mastodon-Async-Refresh without result_count (#36779 by @ClearlyClaire)
• Fix prepared quote not being discarded with contents when replying (#36778 by @ClearlyClaire)

Upgrade notes

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

glitch-v4.5.0-ls307

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.0-ls306...glitch-v4.5.0-ls307

Remote Changes:

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

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Redis has been bumped to 7.0
⚠️ The minimum supported version for PostgreSQL has been bumped to PostgreSQL 14
⚠️ 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
ℹ️ Sidekiq has been updated, which may require you to change health check or monitoring code
ℹ️ 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

• Add support for allowing and authoring quotes (#35355, #35578, #35614, #35618, #35624, #35626, #35652, #35629, #35665, #35653, #35670, #35677, #35690, #35697, #35689, #35699, #35700, #35701, #35709, #35714, #35713, #35715, #35725, #35749, #35769, #35780, #35762, #35804, #35808, #35805, #35819, #35824, #35828, #35822, #35835, #35865, #35860, #35832, #35891, #35894, #35895, #35820, #35917, #35924, #35925, #35914, #35930, #35941, #35939, #35948, #35955, #35967, #35990, #35991, #35975, #35971, #36002, #35986, #36031, #36034, #36038, #36054, #36052, #36055, #36065, #36068, #36083, #36087, #36080, #36091, #36090, #36118, #36119, #36128, #36094, #36129, #36138, #36132, #36151, #36158, #36171, #36194, #36220, #36169, #36130, #36249, #36153, #36299, #36291, #36301, #36315, #36317, #36364, #36383, #36381, #36459, #36464, #36461, #36516, #36528, #36549, #36550, #36559, #36693, #36704, #36690, #36689, #36696, #36721, #36695 and #36736 by @ChaosExAnima, @ClearlyClaire, @Lycolia, @diondiondion, and @tribela)
  This includes a revamp of the composer interface.
  See https://blog.joinmastodon.org/2025/09/introducing-quote-posts/ for a user-centric overview of the feature, and https://docs.joinmastodon.org/client/quotes/ for API documentation.
• Add support for fetching and refreshing replies to the web UI (#35210, #35496, #35575, #35500, #35577, #35602, #35603, #35654, #36141, #36237, #36172, #36256, #36271, #36334, #36382, #36239, #36484, #36481, #36583, #36627 and #36547 by @ClearlyClaire, @diondiondion, @Gargron and @renchap)
• Add ability to block words in usernames (#35407, #35655, and #35806 by @ClearlyClaire and @Gargron)
• Add ability to individually disable local or remote feeds for visitors or logged-in users disabled value to server setting for live and topic feeds, as well as user permission to bypass that (#36338, #36467, #36497, #36563, #36577, #36585, #36607 and #36703 by @ClearlyClaire)
  This splits the timeline_preview setting into four more granular settings controlling live feeds and topic (hashtag, trending link) feeds.
  The setting for local topic feeds has 2 values: public and authenticated. Every other setting has 3 values: public, authenticated, disabled.
  When disabled, users with the “View live and topic feeds” will still be able to view them.
• Add support for displaying of quote posts in Moderator UI (#35964 by @ThisIsMissEm)
• Add support for displaying link previews for Admin UI (#35958 by @ThisIsMissEm)
• Add a new server setting to choose the server landing page (#36588 and #36602 by @ClearlyClaire and @renchap)
• Add support for Update activities on converted object types (#36322 by @ClearlyClaire)
• Add support for dynamic viewport height (#36272 by @e1berd)
• Add support for numeric-based URIs for new local accounts (#32724, #36304, #36316, and #36365 by @ClearlyClaire)
• Add default visualizer for audio upload without poster (#36734 by @ChaosExAnima)
• Add Traditional Mongolian to posting languages (#36196 by @shimon1024)
• Add example post with manual quote approval policy to dev:populate_sample_data (#36099 by @ClearlyClaire)
• Add server-side support for handling posts with a quote policy allowing followers to quote (#36093 and #36127 by @ClearlyClaire)
• Add schema.org markup to SEO-enabled posts (#36075 by @Gargron)
• Add migration to fill unset default quote policy based on default post privacy (#36041 by @ClearlyClaire)
• Add “Posting defaults” setting page, moving existing settings from “Other” (#35896, #36033, #35966, #35969, and #36084 by @ClearlyClaire and @diondiondion)
• Added emoji from Twemoji v16 (#36501 and #36530 by @ChaosExAnima)
• Add feature to select custom emoji rendering (#35229, #35282, #35253, #35424, #35473, #35483, #35505, #35568, #35605, #35659, #35664, #35739, #35985, #36051, #36071, #36137, #36165, #36248, #36262, #36275, #36293, #36341, #36342, #36366, #36377, #36378, #36385, #36393, #36397, #36403, #36413, #36410, #36454, #36402, #36503, #36502, #36532, #36603, #36409, #36638 and #36750 by @ChaosExAnima, @ClearlyClaire and @braddunbar)
  This also completely reworks the processing and rendering of emojis and server-rendered HTML in statuses and other places.
• Add support for exposing conversation context for new public conversations according to FEP-7888 (#35959 and #36064 by @ClearlyClaire and @jesseplusplus)
• Add digest re-check before removing followers in synchronization mechanism (#34273 by @ClearlyClaire)
• Add support for displaying Valkey version on admin dashboard (#35785 by @ykzts)
• Add delivery failure tracking and handling to FASP jobs (#35625, #35628, and #35723 by @oneiros)
• Add example of quote post with a preview card to development sample data (#35616 by @ClearlyClaire)
• Add second set of blocked text that applies to accounts regardless of account age for spam-blocking (#35563 by @ClearlyClaire)

Changed

• Change confirmation dialogs for follow button actions “unfollow”, “unblock”, and “withdraw request” (#36289 by @diondiondion)
• Change “Follow” button labels (#36264 by @diondiondion)
• Change appearance settings to introduce new Advanced settings section (#36496 and #36506 by @diondiondion)
• Change display of blocked and muted quoted users (#36619 by @ClearlyClaire)
  This adds blocked_account, blocked_domain and muted_account values to the state attribute of Quote and ShallowQuote REST API entities.
• Change submitting an empty post to show an error rather than failing silently (#36650 by @diondiondion)
• Change "Privacy and reach" settings from "Public profile" to their own top-level category (#27294 by @ChaelCodes)
• Change number of times quote verification is retried to better deal with temporary failures (#36698 by @ClearlyClaire)
• Change display of content warnings in Admin UI (#35935 by @ThisIsMissEm)
• Change styling of column banners (#36531 by @ClearlyClaire)
• Change recommended Node version to 24 (LTS) (#36539 by @renchap)
• Change min. characters required for logged-out account search from 5 to 3 (#36487 by @Gargron)
• Change browser target to Vite legacy plugin defaults (#36611 by @larouxn)
• Change index on follows table to improve performance of some queries (#36374 by @ClearlyClaire)
• Change links to accounts in settings and moderation views to link to local view unless account is suspended (#36340 by @diondiondion)
• Change redirection for denied registration from web app to sign-in page with error message (#36384 by @ClearlyClaire)
• Change support for RFC9421 HTTP signatures to be enabled unconditionally (#36610 by @oneiros)
• Change wording and design of interaction dialog to simplify it (#36124 by @diondiondion)
• Change dropdown menus to allow disabled items to be focused (#36078 by @diondiondion)
• Change modal background colours in light mode (#36069 by @diondiondion)
• Change “Posting defaults” settings page to enforce nobody quote policy for private default visibility (#36040 by @ClearlyClaire)
• Change description of “Quiet public” (#36032 by @ClearlyClaire)
• Change “Boost with original visibility” to “Share again with your followers” (#36035 by @ClearlyClaire)
• Change handling of push subscriptions to automatically delete invalid ones on delivery (#35987 by @ThisIsMissEm)
• Change design of quote posts in web UI (#35584 and #35834 by @Gargron)
• Change auditable accounts to be sorted by username in admin action logs interface (#35272 by @breadtk)
• Change order of translation restoration and service credit on post card (#33619 by @colindean)
• Change position of ‘add more’ to be inside table toolbar on reports (#35963 by @ThisIsMissEm)
• Change docker-compose.yml sidekiq health check to work for both 4.4 and 4.5 (#36498 by @ClearlyClaire)

Fixed

• Fix relationship not being fetched to evaluate whether to show a quote post (#36517 by @ClearlyClaire)
• Fix rendering of poll options in status history modal (#35633 by @ThisIsMissEm)
• Fix “mute” button being displayed to unauthenticated visitors in hashtag dropdown (#36353 by @mkljczk)
• Fix initially selected language in Rules panel, hide selector when no alternative translations exist (#36672 by @diondiondion)
• Fix URL comparison for mentions in case of empty path (#36613 and #36626 by @ClearlyClaire)
• Fix hashtags not being picked up when full-width hash sign is used (#36103 and #36625 by @ClearlyClaire and @Gargron)
• Fix layout of severed relationships when purged events are listed (#36593 by @mejofi)
• Fix Skeleton placeholders being animated when setting to reduce animations is enabled (#36716 by @ClearlyClaire)
• Fix vacuum tasks being interrupted by a single batch failure (#36606 ...

develop-v4.5.0-rc.3-ls128

CI Report:

N/A

LinuxServer Changes:

Full Changelog: develop-v4.5.0-rc.3-ls127...develop-v4.5.0-rc.3-ls128

Remote Changes:

Data change at JSON endpoint https://api.github.com/repos/mastodon/mastodon/releases