v4.6.0-rc.2

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.6.0 stable release.

Upgrade overview

This release contains upgrade notes that deviate from the norm:

⚠️ The minimum supported version for Ruby has been bumped to 3.3
⚠️ The minimum supported version for Node.JS has been bumped to 22
⚠️ The minimum supported version for FFMpeg has been bumped to 5.1
⚠️ ImageMagick support has been dropped, libvips is required
⚠️ Custom themes need to be updated
ℹ️ Requires assets recompilation
ℹ️ 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.6.0-rc.2)

Added

• Add alt text for default server thumbnail (#39439 by @diondiondion)

Changed

• Change Page Up/Page Down hotkeys to require Alt modifier key (#39427 by @diondiondion)

Fixed

• Fix service worker failing to load due to 404 on chunk dependencies (#39433 by @oliinykdm)
• Fix bio text overflow on account profile page (#39418 by @Coro365)
• Fix hovercard not showing in compose column (#39430 by @diondiondion)
• Fix categorised custom emojis missing from the emoji picker (#39421 by @Hanage999)
• Fix notifications about collections not being destroyed with the underlying collection (#39429 by @oneiros)
• Fix crash on load and navigation in some cases (#39408 by @diondiondion)
• Fix some errors when loading emoji data (#39402 by @ChaosExAnima)
• Fix error with audio player in Safari Lockdown Mode (#39397 by @Federicorao)
• Fix crash of standalone wrapstodon and embedded status pages (#39400 by @diondiondion)

Changelog (v4.6.0-rc.1)

Added

• Add import for custom filters (#39256 by @arte7)
• Add redirection when collection AP ID is requested as HTML (#39361 by @oneiros)
• Add meta tags to Collection HTML (#39357 by @oneiros)
• Add Deprecation headers to collections alpha API (#39349 by @oneiros)
• Add ability to filter notifications from bots (#38809 and #39377 by @evanp and @shleeable)
• Add duration to ActivityPub representation of media attachments (#38061 by @ClearlyClaire)
• Add Stoplight circuit-breaker on Elasticsearch endpoints to better handle some Elasticsearch failures (#39323 and #39375 by @ClearlyClaire and @shleeable)
• Add support for collection URLs in authorized_interactions endpoint (#39287 and #39376 by @ClearlyClaire and @shleeable)
• Add support for collections in search results when searched by URL in web UI (#39289 by @diondiondion)
• Add link to profile editing from “Privacy and reach” (#39309 by @ClearlyClaire)
• Add ability to view individual newsletters in admin UI (#39271 by @Gargron)
• Add Lazuri, Mingrelian and Ottoman Turkish to languages helper (#38648 by @batumi14)
• Add avatar and profile header descriptions to ActivityPub serialization (#39352 by @ClearlyClaire)

Changed

• Change limitation to allow posts with both media and a poll to be created (#39203 and #39368 by @ClearlyClaire and @Gargron)
• Change links to unknown objects to be resolved when posting (#38711 and #39379 by @ClearlyClaire and @shleeable)
• Change web UI navigation to automatically focus the navigated-to modal, post, column header, or compose form (#39350, #39358, and #39360 by @diondiondion)
• Change web UI emoji autocompletion to perform substring search (#39353 and #39382 by @ChaosExAnima)
• Change wording of tootctl preview_cards remove command description to clearly state it only removes media (#39348 by @mjankowski)
• Change rule acceptance link to a form to prevent some crawling behavior (#39283 and #39345 by @ClearlyClaire and @mjankowski)
• Change collection API to enforce a maximum for the pagination limit param (#39342 by @oneiros)
• Change alerts ("toasts") to be announced by assistive tech in web UI (#39335 by @diondiondion)
• Change media attachment limit to 10000 characters (#39306 by @ClearlyClaire)
• Change column headers to move extra buttons out of h1 in web UI (#39305, #39331, and #39356 by @diondiondion)

Removed

• Remove outdated hint for "Use system scrollbar" preference (#39297 by @diondiondion)

Fixed

• Fix account hovercard sometimes not triggering (#39381 by @diondiondion)
• Fix loading/errored emoji in detailed status display name causing line break in web UI (#39378 by @diondiondion)
• Fix empty modal when adding an account to collections from profile when no collection has been created (#39372 by @diondiondion)
• Fix "unlisted collections" profile section incorrectly listing empty collections as unlisted in web UI (#39373 by @diondiondion)
• Fix display of sensitive media cards in web UI according to settings (#39366 by @nshki)
• Fix Elasticsearch connections not being cleaned up properly in Sidekiq middleware (#39359 by @ClearlyClaire)
• Fix font size of Callout component actions in Safari in web UI (#39354 by @diondiondion)
• Fix being unable to unmark media as sensitive when "always mark media as sensitive" is enabled (#39339 by @matrix07012)
• Fix featured collection updates not always being delivered to all featured collection members (#39346 by @oneiros)
• Fix handling of offset in timezone list in settings (#39334 by @mjankowski)
• Fix Delete activities on quote approval stamps and featured collection stamps not being signed (#39047 by @shleeable)
• Fix various accessibility issues caused by "simple" ruby gems (#39325 by @diondiondion)
• Fix tiny checkboxes and radio buttons in Safari (#39332 by @diondiondion)
• Fix inconsistent keyboard_shortcuts.translate string (#39328 by @noelleleigh)
• Fix alignment of icon and text in Callout component (#39324 by @diondiondion)
• Fix naming of custom filter export attribute (#39304 by @arte7)
• Fix "change thumbnail" button being visible when it shouldn't (#38467 by @dpbento)
• Fix collections editor allowing to add the same account multiple times (#39296 by @diondiondion)
• Fix robustness of post/feed navigation by hotkey (#39270 by @diondiondion)
• Fix blocked domains not being removed from the Instance search index (#39109 by @shleeable)
• Fix account data fetching when loading many collections at once (#39286 by @diondiondion)
• Fix logged out users being able to access confusing collection and list creation routes (#39282 by @diondiondion)
• Fix some inputs incorrectly having resize handles in Firefox (#39274 by @diondiondion)

Changelog (v4.6.0-beta.1)

Added

• Add collections (#37992, #37005, #37049, #37020, #37053, #37110, #37117, #37122, #37154, #37157, #37176, #37192, #37222, #37225, #37254, #37277, #37298, #37322, #37434, #37468, #37514, #37512, #37549, #37556, #37560, #37580, #37591, #37552, #37618, #37643, #37658, #37731, #37678, #37741, #37762, #37790, #37805, #37823, #37837, #37842, #37850, #37848, #37812, #37950, #37898, #37916, #37920, #37927, #37928, #37961, #37967, #37974, #37989, #37986, #38004, #38026, #38027, #38030, #38038, #38065, #38081, #38082, #38096, #38106, #38113, #38124, #38133, #38144, #38153, #38166, #38167, #38169, #38170, #38177, #38193, #38213, #38251, #38255, #38256, #38282, #38298, #38292, #38307, #38306, #38316, #38115, #38329, #38334, #38337, #38351, #38368, #38370, #38356, #38383, #38386, #38385, #38394, #38393, #38399, #38402, #38409, #38414, #38413, #38424, #38425, #38450, #38508, #38528, #38534, #38536, #38540, #38543, #38491, #38586, #38611, #38588, #38612, #38628, #38626, #38630, #38633, #38629, #38638, #38645, #38644, #38636, #38660, #38657, #38688, #38690, #38672, #38698, #38697, #38708, #38712, #38713, #38709, #38719, #38728, #38730, #38732, #38739, #38749, #38751, #38750, #38767, #38769, #38783, #38785, #38959, #38786, #38794, #38776, #38817, #38792, #38822, #38827, #38831, #38830, #38844, #38843, #38852, #38850, #38847, #38865, #38897, #38900, #38919, #38933, #38934, #38935, #38942, #38941, #38954, #38961, #38957, #38962, #38991, #39009, #39062, #39029, #39069, #39020, #39073, #39082, #39096, #39080, #39182, #39143, #39127, #37929, #38029, #39194, #39198, #39210, #39211, #39202, #39214, #39215, #39220, #39234, #39260, and #39251 by @ChaosExAnima, @ClearlyClaire, @Gargron, @arte7, @diondiondion, @mjankowski, @oneiros, and @shleeable)
  • Create collections with up to 25 accounts each, then share them with others. You can read more about this feature on our blog. This is based on FEP-7aa9 (Featured Collections) to be interoperable with the wider Fediverse. All the new API methods are documented here.
• Add email subscriptions (#38163, #38507, #38502, #38487, #38527, #38582, #38741, #38907, and #39162 by @ClearlyClaire and @Gargron)
  • Admins can allow specific roles to enable email subscriptions on their profile, allowing anonymous visitors to subscribe to their posts via email.
• Add new overview landing page setting (#39074, #39170, #39163, and #39138 by @Gargron, @diondiondion, and @zunda)
  • Admins can choose a new frontpage for anonymous visitors, which combines the about page and most recent posts from local profiles.
• Add ability to require 2FA for specific roles (including Everybody) (#37701, #37846, and #38906 by @ClearlyClaire and @mjankowski)
• Add export for custom filters (#39085 by @arte7)
• Add ability to search email blocks by domain in admin UI (#38923 by @arte7)
• Add new endpoints for profile editing in REST API (#37912, #37934, #37932, #38221, and #38339 by @ClearlyClaire)
  • Add GET /api/v1/profile and PATCH /api/v1/profile to replace the existing update_credentials endpoint. See the documentation for more information.
• Add missing_attribution boolean to preview cards in REST API (#38043 by @ClearlyClaire)
  • Documentation: https://docs.joinmastodon.org/entities/PreviewCard/#missing_attribution
• Add exclude_direct flag to /api/v1/accounts/:id/statuses to exclude direct messages (#37763 by @ClearlyClaire)
• Add max_note_length and max_display_name_length attributes to configuration.accounts in Instance entity (#37991 by @ClearlyClaire)
• Add profile field limits to instance entity in REST API (#37535 by @mkljczk)
  • This adds attributes configuration.accounts.max_profile_fields, configuration.accounts.profile_field_name_limit and configuration.accounts.profile_field_value_limit to the Instance entity.
• Add unresolved flag to /api/v1/admin/reports to query both resolved and unresolved reports (#38323 by @mkljczk)
• Add fallback attributes to notifications for new and infrequent notifications in REST API (#38832 and #38860 by @ClearlyClaire)
  • This adds a supported_types parameter to GET /api/v1/notifications, GET /api/v1/notifications/:id, GET /api/v2/notifications, and GET /api/v2/notifications/:group_key along with a new fallback attribute for notifications and notification groups.
• Add support for posts in vertical languages in web UI (#37204, #38205, and #38797 by @shimon1024)
• Add PageUp and PageDown hotkeys for list navigation (#39252 by @diondiondion)
• Add g+e keyboard shortcut to access the trending page in web UI (#38014 by @antoinecellerier)
• Add Cmd/Ctrl+Enter for form submissions in more text areas in web UI (#37821 by @diondiondion)
• Add support for quoting by dragging a link into the compose form in web UI (#36859 and #36896 by @ClearlyClaire and @tribela)
• Add text-autospace to posts to improve rendering of mixed script posts in web UI (#37694 by @ahxxm)
• Add nan-TW to supported locales (#37650, #34923, #37822, and #37721 by @ClearlyClaire and @Yoxem)
• Add support for hosts resolver in request socket DNS lookup (#38699, #38866, and #39030 by @ClearlyClaire and @mjankowski)
• Add support for FEP-2c59 (Webfinger Backlink) (#38239, #38538, and #38639 by @ClearlyClaire and @shleeable)
• Add support for FEP-3b86 (Activity Intents) (#38120 and #38130 by @ClearlyClaire and @Gargron)
• Add support for alt text for profile pictures and headers (#37634, #37641, and #38000 by @ClearlyClaire and @Doxterpepper)
• Add support for multiple keypairs for remote accounts (#38279, #38407, #38419, #38511, #38516, #38515, #38555 and #39235 by @ClearlyClaire)
• Add support for the “require approval” feature for email domain blocks to tootctl email_domain_blocks (#34579 and #38107 by @ClearlyClaire and @e-nomem)
• Add --keep-interacted flag to tootctl media remove to preserve cached media on cleanup (#36200 by @northerner)
• Add systemd service file for prometheus exporter (#35130 by @ThisIsMissEm)

Changed

• Change design of profiles in web UI (#37472, #37490, #37479, #37513, #37527, #37550, #37538, #37632, #37627, #37593, #37638, #37626, #37645, #37653, #37683, #37707, #37682, #37742, #37747, #37760, #37761, #37831, #37766, #37811, #37813, #37825, #37854, #37851, #37876, #37885, #37892, #37890, #37907, #37922, #37952, #37958, #37996, #37990, #37994, #38005, #38012, #38040, #38052, #38066, #38083, #38147, #38148, #38152, #38168, #38156, #38175, #38191, #38189, #38235, #38283, #38310, #38309, #38315, #38314, #38365, #38366, #38363, #38346, #38382, #38384, #38400, #38404, #38417, #38426, #38440, #38442, #38443, #38445, #38446, #38451, #38456, #38509, #38510, #38512, #38513, #38517, #38529, #38531, #38535, #38532, #38544, #38549, #38575, #38579, #38580, #38581, #38585, #38584, #38604, #38605, #38606, #38607, #38622, #38616, #38625, #38632, #38640, #38663, #38667, #38646, #38691, #38692, #38766, #38791, #38687, #38826, #38828, #38863, #38845, #38870, #38872, #38932, #38945, #38963, #38964, #39055, #39042, #38893, #39079, #39084, #39160, #39070, and #39217 by @ChaosExAnima, @ClearlyClaire, @Coro365, @diondiondion, and @shleeable)
  • The profile screen has been entirely redesigned, has new features, and allows you to update your own profile directly without going into the preferences panel. You can read more about it on our blog.
• Change how #Wrapstodon reports are generated and displayed (#37033, #37045, #37093, #37055, #37096, #37047, #37103, #37104, #37106, #37109, #37121, #37138, #37134, #37177, #37182, #37169, #37186, #37187, #37188, #37189, #37190, #37193, #37198, #37201, #37203, #37205, #37206, #37207, #37209, #37202, #37216, #37219, #37224, #37226, #37229, #37249, #37251, #37256, #37261, #37269, #37270, #37273, and #37289 by @ChaosExAnima, @ClearlyClaire, @channyeintun, and @diondiondion)
  • This finishes up work started in 2024 by completely revamping how Wrapstodon reports are generated and displayed, reducing the amount of data collected and generating reports when active users ask for them.
  • Instead of requiring manual generation from a server administrator, this is now offered between the 10th of December and the end of each year if enabled in the server settings.
  • The design of the Wrapstodon report has also been fully reworked to be more delightful and easier to share!
  • The relevant API endpoints are documented at https://docs.joinmastodon.org/methods/annual_reports/
• Change pending user notification email to link directly to the pending account (#39206 by @vmstan)
• Changed emoji processing in web UI to make it less resource intensive and more robust (#39077, #39008, #39088, #38892, #38885, #38965, #38854, #38825, #38784, #38541, #37442, #37300, #37306, #37271, #37255, #37284, #37272, #37178, #37084, #37080, #37418, #39167, and #39126 by @ChaosExAnima, @ClearlyClaire, @diondiondion, and @gomasy)
• Change composer textarea to have a limited height to prevent column scrolling (#39268 by @diondiondion)
• Change mentions of “Mastodon gGmbH” to “Mastodon GmbH” (#39261 by @renchap)
• Change the limited profile message to be less misleading (#39231 by @mortie)
• Change images/videos in posts in web UI to not have unlimited height (#36966, #37035, #37136, and #37032 by @diondiondion)
• Change search field and tabs to stick to the top on the search results page in web UI (#38968 by @diondiondion)
• Change “anyone can quote” label to “quotes allowed” in web UI (#37427 by @vmstan)
• Change navigation by j/k hotkeys to anchor navigated item to top of viewport in web UI (#38036 by @diondiondion)
• Change hotkeys to focus columns to not reset scroll, add hotkey 0 to scroll to top in web UI (#37052 by @diondiondion)
• Change media modal swipe animation in web UI (#36916, #37034, #37323, and #37464 by @ChaosExAnima and @heathdutton)
• Change “Hide”/“Show all” eye icon in thread view in web UI (#22301 by @tribela)
• Change order of onboarding steps (follow people, then fill out profile) in web UI (#38121 by @Gargron)
• Change “Why do you want to join” field on the sign-up page to have a label (#38936 by @diondiondion)
• Change date of birth field on the sign-up page to use locale-specific fields order (#36039 and #36895 by @mjankowski)
• Change how invalid-but-not-expired invites are shown in admin UI (#38736 by @ClearlyClaire)
• Change wording and ordering of media display settings (#38731 by @mjankowski)
• Change wording of server account recommendation setting description (#36771 by @mjankowski)
• Change wording and ordering of account migration warnings (#20387 by @jsoref)
• Change wording of “Automatic post deletion” settings (#37286 by @mjankowski)
• Change wording of language filter settings to clarify they do not impact home/lists (#38490 by @mjankowski)
• Change invitations to only bypass sign-up approval setting when the issuer of the invitation has the invite_bypass_approval permission (#38278 by @ClearlyClaire)
  • This splits the “Invite Users” permission into a new “Invite Users without review” permission.
  • Existing roles will be updated to have the new permission if they have the old one, but default permissions will not include the new invite_bypass_approval permission.
• Change followers synchronization mechanism on followers-only posts to be skipped for accounts with 25k followers or more (#37302 by @ClearlyClaire)
• Change “dark”, “light” and “high contrast” themes to be separate “Color scheme” and “Contrast” settings handled by a single theme (#37095, #37120, #37288, #37459, #37470, #37477, #37519, #37520, #37523, #37524, #37526, #37612, #37824, #37807, #37810, #37819, #37906, and #38261 by @ClearlyClaire, @diondiondion, and @mjankowski)
  • Existing settings should be migrated automatically from user settings, and using browser defaults otherwise.
  • This also allows third-party theme authors to make use of the same browser defaults and user settings. Learn more about this in our new Theming docs.
• Change default theme to use CSS theme tokens (#36861, #36936, #37019, #37054, #37056, #37081, #37105, #37268, #37841, #37843, #38387, #38459, and #38621 by @diondiondion)
  • A guide to using the new tokens can be found in our docs.
• Change location blocks in default nginx.conf (#19644 and #37866 by @BedrockDigger and @Izorkin)
• Change proxy_read_timeout to 120 seconds in default nginx.conf (#30599 by @shleeable)
• Change JSON-LD collection handling (#34595 and #37806 by @ClearlyClaire and @sneakers-the-rat)

Removed

• Remove support for EOL Node version 20 (#38926 by @mjankowski)
• Remove support for Ruby 3.2 (#37476 by @mjankowski)
• Remove support for ENABLE_SIDEKIQ_UNIQUE_JOBS_UI (#38340 by @ClearlyClaire)
• Remove support for ImageMagick (#37488 by @mjankowski)

Fixed

• Fix accessibility issues in web UI (#37250, #38006, #38033, #38188, #38230, #38252, #38257, #38285, #38293, #38362, #38387, #38459, #38796, #38801, #39098, #39111, #39120, #39129, #39133, #39134, #39144, #39145, #39149, #39164, #39165, #39169, and #39181 by @ChaosExAnima and @diondiondion)
• Fix processing some link previews where text is language-tagged (#39190 by @zunda)
• Fix error when “New trends” email is sent at the same time trends are recomputed (#39122 by @arte7)
• Fix hover card opening even when not preceded by mouse movement in web UI (#39166 by @diondiondion)
• Fix ominous "Moments remaining" timestamp in web UI (#38488 and #38689 by @ChaosExAnima and @MitarashiDango)
• Fix filters not being applied to search results in web UI (#36346 by @ClearlyClaire)
• Fix error when visiting non-public hashtag timelines (#36961 by @diondiondion)
• Fix duplicate favourite/boost counters in some languages (#36844 by @ChaosExAnima)
• Fix unblocking domain from blocked domains column not updating the list in web UI (#38882 by @tribela)
• Fix profile dropdown menu sometimes ending with a separator in web UI (#38481 by @mkljczk)
• Fix short numbers rounding up instead of truncating in web UI (#38114 by @serranodfm)
• Fix directory showing load more button when no more profiles exist in web UI (#37465 by @heathdutton)
• Fix focus restoration after closing some modals in web UI (#37424 by @MegaManSec)
• Fix video modals being pushed down on mobile in web UI (#37421 by @ChaosExAnima)
• Fix outer page margins when viewport width equals content width in web UI (#36733 by @diondiondion)
• Fix announcement margin when in advanced web UI (#36714 by @ChaosExAnima)
• Fix navigation overflow issue in advanced web UI (#39178 by @diondiondion)
• Fix stale merging stale account from cached instance API response in web UI (#37666 by @ChaosExAnima)
• Fix HTML lang attribute being stripped out of remote posts (#39114 by @artemist)
• Fix remote posts with large media descriptions being rejected (#39135 by @ClearlyClaire)
• Fix some occurrence of PostgreSQL log pollution when processing new hashtags (#35792 by @oelison)
• Fix replica database not being used when REPLICA_DB_HOST is used but neither REPLICA_DB_NAME nor REPLICA_DATABASE_URL (#37240 by @smiba)
• Fix remote media attachment thumbnails not being stored in the cache/ directory (#36911 by @shugo)
• Fix race condition when processing posts twice with the same idempotency key (#37879 by @ClearlyClaire)
• Fix various missing translation strings (#37671, #37838, #37078, #37371, and #37827 by @ClearlyClaire, @mjankowski, and @valtlai)
• Fix last post time for remote accounts not being accurately tracked (#37619 by @ClearlyClaire)
• Fix filtering of mentions from filtered-on-their-origin-server accounts (#37583 by @ClearlyClaire)
• Fix irrelevant remote accounts being passed through to local fan-out worker (#37589 by @ClearlyClaire)
• Fix required field markers being displayed on fields that cannot be empty anyway in settings (#37291 by @diondiondion)
• Fix thumbnails for links from The Guardian (and possibly other CDNs that check URL hashes) not showing up (#36139 by @phocks)
• Fix mastodon-async-refresh response header not being exposed through CORS (#38914 by @mkljczk)
• Fix FASP availability being incorrectly updated (#38818 by @oneiros)
• Fix use of deprecated vsync FFmpeg option, using fps_mode instead (FFmpeg >= 5.1 now required) (#38198 by @mjankowski)
• Fix unnecessary downcasing of some words in admin UI (#37364 by @ClearlyClaire)
• Fix delivery worker counting unsalvageable HTTP errors as successes (#37235 by @shleeable)
• Fix streaming heartbeat comment not being its own event (#37389 by @ClearlyClaire)
• Fix posts with edited out media attachments being returned in GET /api/v1/accounts/:id/statuses?only_media=true (#37363 by @ClearlyClaire)
• Fix wrong media attachment URLs being returned from DELETE /api/v1/statuses/:id (#35880 by @dbarabashh)
• Fix hashtag matching by replacing negative look-behind with positive look-behind (#37684 and #38212 by @ClearlyClaire)
• Fix discovery of ActivityPub representation from HTML tags in presence of a non-ActivityPub alternate Link header (#37439 by @shleeable)
• Fix Webfinger endpoint not handling new ActivityPub ID scheme (#38391 by @ClearlyClaire)
• Fix error when admin-selected theme does not exist by falling back to default theme (#38703 by @shleeable)
• Fix wrong endonyms for Divehi and Latvian in languages list (#36254 and #36876 by @cuu508 and @shimon1024)
• Fix Accept headers when fetching ActivityPub resources not including JSON-LD profile (#30354 by @TheOneric)
• Fix wrong hover indicators on unclickable items in admin UI (#38782 by @diondiondion)
• Fix streaming server using deprecated url.parse instead of WHATWG URL API (#36973 by @Exagone313)

Upgrade notes

To get the code for v4.6.0-rc.2, use git fetch && git checkout v4.6.0-rc.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 changed since v4.5.0, with new Ruby, Node and FFMpeg version requirements.

• 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

ImageMagick removal and libvips replacement

ImageMagick has been deprecated since Mastodon 4.4.0 and is now unsupported. If you used MASTODON_USE_LIBVIPS=false, this will be ignored and you will need to install libvips.

Theming system changes

The theming system has changed substantially, changing how light and dark themes work, as well as high-contrast. We also overhauled the whole theme to use design tokens and CSS variables.

Custom themes will most likely require significant changes to work with Mastodon 4.6.0.

If you are a theme author, please see our documentation at https://docs.joinmastodon.org/dev/frontend/theming/ and https://docs.joinmastodon.org/dev/frontend/design-tokens/

Email subscription feature and additional costs

Mastodon 4.6 introduces a new feature that lets users turn their public posts into mailing lists. This can result in an increased amount of sent emails and thus increased costs.

This feature needs to be enabled by a Mastodon user with administrator privileges, then opted-in by individual users.

In situations where the Mastodon administrators and the people hosting the server are not the same people, such as providers that offer Mastodon as a service, the system administrators may want to disable this feature. This can be done by setting the DISABLE_EMAIL_SUBSCRIPTIONS environment variable to true.

Update steps

The following instructions are for updating from 4.5.11. They also apply for migration from v4.6.0-beta.1 and v4.6.0-rc.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. If you are using rbenv, update the list of available versions and install the proper Ruby version by doing RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install in the Mastodon install directory (e.g. /home/mastodon/live)
2. Install dependencies with bundle install and yarn install --immutable
3. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
4. Run the pre-deployment database migrations by specifying the SKIP_POST_DEPLOYMENT_MIGRATIONS=true environment variable: SKIP_POST_DEPLOYMENT_MIGRATIONS=true RAILS_ENV=production bundle exec rails db:migrate
5. Restart all Mastodon processes.
6. Run the post-deployment database migrations: RAILS_ENV=production bundle exec rails db:migrate

When using Docker

1. Run the pre-deployment database migrations by specifying the SKIP_POST_DEPLOYMENT_MIGRATIONS=true environment variable: docker-compose run --rm -e SKIP_POST_DEPLOYMENT_MIGRATIONS=true web bundle exec rails db:migrate
2. Restart all Mastodon processes.
3. Run the post-deployment database migrations: docker-compose run --rm web bundle exec rails db:migrate