# Mastodon changelog
> A free, decentralized social network server.
- Vendor: Mastodon gGmbH
- Category: Communication
- Official site: https://joinmastodon.org
- Tracked by: What's New (https://whatsnew.fyi/product/mastodon)
- Harvested from: GitHub (mastodon/mastodon)
- Entries below: 10 (newest first)
What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.
## Releases
### v4.4.22
- Date: 2026-08-06
- Version: v4.4.22
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.4.22
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.4.22
- **fixed** — Fix typo in embedded quote handling code
- **fixed** — Fix account merging worker incorrectly merging Appeal and AccountWarning records
- **fixed** — Fix off-by-one in handling of updated remote posts allowing up to 5 attachments
> [!NOTE]
> While we continue to support Mastodon 4.4 and release patches for it, please note that Mastodon 4.6 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.6 version when they can.
##### Changelog
###### Fixed
- Fix typo in embedded quote handling code (#40049 by @shleeable)
- Fix account merging worker incorrectly merging `Appeal` and `AccountWarning` records (#39982 by @shleeable)
- Fix off-by-one in handling of updated remote posts allowing up to 5 attachments (#39978 by @shleeable)
##### Upgrade notes
To get the code for v4.4.22, use `git fetch && git checkout v4.4.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`
###### 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.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. In particular, it is very important to read the [4.4.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.4.0).
1. Restart all Mastodon processes.
### v4.5.15
- Date: 2026-08-06
- Version: v4.5.15
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.5.15
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.5.15
- **fixed** — Fix typo in embedded quote handling code
- **fixed** — Fix account merging worker incorrectly merging Appeal and AccountWarning records
- **fixed** — Fix off-by-one in handling of updated remote posts allowing up to 5 attachments
##### Changelog
###### Fixed
- Fix typo in embedded quote handling code (#40049 by @shleeable)
- Fix account merging worker incorrectly merging `Appeal` and `AccountWarning` records (#39982 by @shleeable)
- Fix off-by-one in handling of updated remote posts allowing up to 5 attachments (#39978 by @shleeable)
##### Upgrade notes
To get the code for v4.5.15, use `git fetch && git checkout v4.5.15`.
> [!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.14.
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](https://github.com/mastodon/mastodon/releases/tag/v4.5.0).
1. Restart all Mastodon processes.
### v4.6.5
- Date: 2026-08-06
- Version: v4.6.5
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.6.5
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.6.5
- **fixed** — Fix Collection items being rejected because of incorrect attribute being read
- **fixed** — Fix typo in embedded quote handling code
- **fixed** — Fix account merging worker incorrectly merging Appeal and AccountWarning records
- **fixed** — Fix off-by-one in handling of updated remote posts allowing up to 5 attachments
- **fixed** — Fix collection items limit not being consistently applied
- **fixed** — Fix oversized profile image crop uploads
- **fixed** — Fix emoji autocomplete sometimes suggesting emojis for earlier keystrokes
##### Upgrade overview
This release contains upgrade notes that deviate from the norm:
ℹ️ Requires assets recompilation
For more information, view the complete release notes and scroll down to the upgrade instructions section.
##### Changelog
###### Fixed
- Fix Collection items being rejected because of incorrect attribute being read (#40052 by @shleeable)
- Fix typo in embedded quote handling code (#40049 by @shleeable)
- Fix account merging worker incorrectly merging `Appeal` and `AccountWarning` records (#39982 by @shleeable)
- Fix off-by-one in handling of updated remote posts allowing up to 5 attachments (#39978 by @shleeable)
- Fix collection items limit not being consistently applied (#39969 by @oneiros)
- Fix oversized profile image crop uploads (#39958 by @sharlayan)
- Fix emoji autocomplete sometimes suggesting emojis for earlier keystrokes (#39947 by @ChaosExAnima)
##### Upgrade notes
To get the code for v4.6.5, use `git fetch && git checkout v4.6.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.6.0.
- 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
###### Update steps
The following instructions are for updating from 4.6.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.6.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.6.0).
###### Non-Docker
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.21
- Date: 2026-07-27
- Version: v4.4.21
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.4.21
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.4.21
- **security** — Fix incorrect permission enforcement
- **security** — Fix SSRF protection bypass via IPv4-compatible IPv6 addresses
- **security** — Update dependencies
- **fixed** — Fix performance of user-focused queries in admin dashboard
- **fixed** — Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens
- **fixed** — Fix ActivityPub::Activity::Create trying to re-create known statuses when author changes
- **fixed** — Fix lax relevancy check in inbound activity processing
- **fixed** — Fix Account::Merging concern not supporting Quotes, refactor it
- **fixed** — Fix suspended accounts not being removed from follow request count in /api/v1/accounts/verify_credentials
- **fixed** — Fix followed tags not being properly cleaned up when an account is deleted
- **fixed** — Fix autofollow option being ignored in invite moderation interface
> [!NOTE]
> While we continue to support Mastodon 4.4 and release patches for it, please note that Mastodon 4.6 is available with new features, changes and fixes. We encourage administrators to update to the latest 4.6 version when they can.
##### Changelog
###### Security
- Fix incorrect permission enforcement ([GHSA-7jvv-fhmg-wpfw](https://github.com/mastodon/mastodon/security/advisories/GHSA-7jvv-fhmg-wpfw))
- Fix SSRF protection bypass via IPv4-compatible IPv6 addresses ([GHSA-vwhj-3g83-v276](https://github.com/mastodon/mastodon/security/advisories/GHSA-vwhj-3g83-v276))
- Update dependencies
###### Fixed
- Fix performance of user-focused queries in admin dashboard (#39929 by @ClearlyClaire)
- Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens (#39918 by @ClearlyClaire)
- Fix `ActivityPub::Activity::Create` trying to re-create known statuses when author changes (#39916 by @ClearlyClaire)
- Fix lax relevancy check in inbound activity processing (#39892 by @ClearlyClaire)
- Fix `Account::Merging` concern not supporting Quotes, refactor it (#39884 by @ClearlyClaire)
- Fix suspended accounts not being removed from follow request count in `/api/v1/accounts/verify_credentials` (#39858 by @ClearlyClaire)
- Fix followed tags not being properly cleaned up when an account is deleted (#39824 by @shleeable)
- Fix autofollow option being ignored in invite moderation interface (#39819 by @shleeable)
##### Upgrade notes
To get the code for v4.4.21, use `git fetch && git checkout v4.4.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`
###### 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.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. In particular, it is very important to read the [4.4.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.4.0).
###### 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`
2. Restart all Mastodon processes.
###### When using Docker
1. Restart all Mastodon processes.
### v4.5.14
- Date: 2026-07-27
- Version: v4.5.14
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.5.14
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.5.14
- **security** — Fix incorrect permission enforcement
- **security** — Fix SSRF protection bypass via IPv4-compatible IPv6 addresses
- **security** — Update dependencies
- **fixed** — Fix being unable to vote in polls without an expiration date
- **fixed** — Fix performance of user-focused queries in admin dashboard
- **fixed** — Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens
- **fixed** — Fix ActivityPub::Activity::Create trying to re-create known statuses when author changes
- **fixed** — Fix typo in quotes list error handling
- **fixed** — Fix lax relevancy check in inbound activity processing
- **fixed** — Fix Account::Merging concern not supporting Quotes, refactor it
- **fixed** — Fix suspended accounts not being removed from follow request count in /api/v1/accounts/verify_credentials
- **fixed** — Fix followed tags not being properly cleaned up when an account is deleted
- **fixed** — Fix CW being copied to body when editing quote posts with empty text
- **fixed** — Fix handling of QuoteRequest rejections when those can't be found by id
- **fixed** — Fix autofollow option being ignored in invite moderation interface
##### 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 incorrect permission enforcement ([GHSA-7jvv-fhmg-wpfw](https://github.com/mastodon/mastodon/security/advisories/GHSA-7jvv-fhmg-wpfw))
- Fix SSRF protection bypass via IPv4-compatible IPv6 addresses ([GHSA-vwhj-3g83-v276](https://github.com/mastodon/mastodon/security/advisories/GHSA-vwhj-3g83-v276))
- Update dependencies
###### Fixed
- Fix being unable to vote in polls without an expiration date (#39949 by @ClearlyClaire)
- Fix performance of user-focused queries in admin dashboard (#39929 by @ClearlyClaire)
- Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens (#39918 by @ClearlyClaire)
- Fix `ActivityPub::Activity::Create` trying to re-create known statuses when author changes (#39916 by @ClearlyClaire)
- Fix typo in quotes list error handling (#39904 by @shleeable)
- Fix lax relevancy check in inbound activity processing (#39892 by @ClearlyClaire)
- Fix `Account::Merging` concern not supporting Quotes, refactor it (#39884 by @ClearlyClaire)
- Fix suspended accounts not being removed from follow request count in `/api/v1/accounts/verify_credentials` (#39858 by @ClearlyClaire)
- Fix followed tags not being properly cleaned up when an account is deleted (#39824 by @shleeable)
- Fix CW being copied to body when editing quote posts with empty text (#39823 and #39837 by @shleeable and @ClearlyClaire)
- Fix handling of `QuoteRequest` rejections when those can't be found by `id` (#39820 by @shleeable)
- Fix autofollow option being ignored in invite moderation interface (#39819 by @shleeable)
##### Upgrade notes
To get the code for v4.5.14, use `git fetch && git checkout v4.5.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.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.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.5.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.5.0).
###### 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.6.4
- Date: 2026-07-27
- Version: v4.6.4
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.6.4
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.6.4
- **security** — Fix incorrect permission enforcement
- **security** — Fix SSRF protection bypass via IPv4-compatible IPv6 addresses
- **security** — Update dependencies
- **changed** — Change autosuggestions to include second word in web UI
- **fixed** — Fix being unable to vote in polls without an expiration date
- **fixed** — Fix performance of user-focused queries in admin dashboard
- **fixed** — Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens
- **fixed** — Fix ActivityPub::Activity::Create trying to re-create known statuses when author changes
- **fixed** — Fix typo in quotes list error handling
- **fixed** — Fix lax relevancy check in inbound activity processing
- **fixed** — Fix Account::Merging concern not supporting Quotes or Collections
- **fixed** — Fix various emoji search issues
- **fixed** — Fix swapped order of accept/reject actions in follow requests
- **fixed** — Fix suspended accounts not being removed from follow request count in /api/v1/accounts/verify_credentials
- **fixed** — Fix Learn more link target in column post privacy hint
- **fixed** — Fix page refresh when trying to save custom profile fields
- **fixed** — Fix followed tags not being properly cleaned up when an account is deleted
- **fixed** — Fix CW being copied to body when editing quote posts with empty text
- **fixed** — Fix handling of QuoteRequest rejections when those cannot be found by id
- **fixed** — Fix autofollow option being ignored in invite moderation interface
##### 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 incorrect permission enforcement ([GHSA-7jvv-fhmg-wpfw](https://github.com/mastodon/mastodon/security/advisories/GHSA-7jvv-fhmg-wpfw), [GHSA-hx34-2pfw-2qfj](https://github.com/mastodon/mastodon/security/advisories/GHSA-hx34-2pfw-2qfj))
- Fix SSRF protection bypass via IPv4-compatible IPv6 addresses ([GHSA-vwhj-3g83-v276](https://github.com/mastodon/mastodon/security/advisories/GHSA-vwhj-3g83-v276))
- Update dependencies
###### Changed
- Change autosuggestions to include second word in web UI (#39622 and #39696 by @Gargron and @zunda)
###### Fixed
- Fix being unable to vote in polls without an expiration date (#39949 by @ClearlyClaire)
- Fix performance of user-focused queries in admin dashboard (#39929 by @ClearlyClaire)
- Fix Web Push subscription deletion endpoint incorrectly expecting anti-CSRF tokens (#39918 by @ClearlyClaire)
- Fix `ActivityPub::Activity::Create` trying to re-create known statuses when author changes (#39916 by @ClearlyClaire)
- Fix typo in quotes list error handling (#39904 by @shleeable)
- Fix lax relevancy check in inbound activity processing (#39892 by @ClearlyClaire)
- Fix `Account::Merging` concern not supporting Quotes or Collections, refactor it (#39884 by @ClearlyClaire)
- Fix various emoji search issues (#39815 by @ChaosExAnima)
- Fix swapped order of "accept/reject" actions in follow requests (#39862 by @diondiondion)
- Fix suspended accounts not being removed from follow request count in `/api/v1/accounts/verify_credentials` (#39858 by @ClearlyClaire)
- Fix "Learn more" link target in column post privacy hint (#39829 by @diondiondion)
- Fix page refresh when trying to save custom profile fields (#39828 by @diondiondion)
- Fix followed tags not being properly cleaned up when an account is deleted (#39824 by @shleeable)
- Fix CW being copied to body when editing quote posts with empty text (#39823 and #39837 by @shleeable and @ClearlyClaire)
- Fix handling of `QuoteRequest` rejections when those can't be found by `id` (#39820 by @shleeable)
- Fix autofollow option being ignored in invite moderation interface (#39819 by @shleeable)
- Fix pagination overlapping announcement reactions bar (#39814 by @diondiondion)
- Fix very wide images overflowing posts horizontally (#39812 by @diondiondion)
- Fix collections not being removed when an account is deleted (#39809 by @oneiros)
- Fix account followed languages selector (#39801 by @ChaosExAnima)
- Fix error handling in `ActivityPub::ProcessFeaturedItemService` (#39787 by @ClearlyClaire)
- Fix display of past relative times (#39742 by @ClearlyClaire)
- Fix pinned post button width (#39724 by @ChaosExAnima)
##### Upgrade notes
To get the code for v4.6.4, use `git fetch && git checkout v4.6.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.6.0.
- 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
####
_[Truncated at 4000 characters — full notes: https://github.com/mastodon/mastodon/releases/tag/v4.6.4]_
### v4.6.3
- Date: 2026-07-03
- Version: v4.6.3
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.6.3
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.6.3
- **security** — Update dependencies
- **added** — Add "Update available" navigation item at top of navbar when new Mastodon versions are available
- **added** — Add rendering of post images in emails
- **fixed** — Fix "view collection" menu item appearing on collection page
- **fixed** — Fix incorrect filter cache key sometimes causing incorrect filters to be applied
- **fixed** — Fix missing `to_json` to publish announcement reaction worker
- **fixed** — Fix duplicate "clear" button shown in main search input in Chrome
- **fixed** — Fix visual glitch with the spoiler button
- **fixed** — Fix invisible username during post highlight animation
- **fixed** — Fix follow button floating on profiles when overview landing page is enabled
- **fixed** — Fix encryption warning "read more" link
- **fixed** — Fix `tootctl media lookup` failing on some setups
- **fixed** — Fix visible transparent navigation link borders in Windows forced-contrast mode
- **fixed** — Fix crash with some browser extensions injecting custom elements in the page
##### 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
- Update dependencies
###### Added
- Add “Update available” navigation item at top of navbar when new Mastodon versions are available (#39705 by @ClearlyClaire)
- Add rendering of post images in emails (#39636 by @diondiondion)
###### Fixed
- Fix “view collection” menu item appearing on collection page (#39694 by @mkljczk)
- Fix incorrect filter cache key sometimes causing incorrect filters to be applied (#39698 by @ClearlyClaire)
- Fix missing `to_json` to publish announcement reaction worker (#39685 by @mjankowski)
- Fix duplicate "clear" button shown in main search input in Chrome (#39679 by @diondiondion)
- Fix visual glitch with the spoiler button (#39677 by @ChaosExAnima)
- Fix invisible username during post highlight animation (#39659 by @diondiondion)
- Fix follow button floating on profiles when overview landing page is enabled (#39650 by @FFederi)
- Fix encryption warning "read more" link (#39635 by @thomas-pike)
- Fix `tootctl media lookup` failing on some setups (#39615 by @brookmiles)
- Fix visible transparent navigation link borders in Windows forced-contrast mode (#39614 by @diondiondion)
- Fix crash with some browser extensions injecting custom elements in the page (#39507 by @OriginalRoOhi)
##### Upgrade notes
To get the code for v4.6.3, use `git fetch && git checkout v4.6.3`.
> [!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.6.0.
- 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
###### Update steps
The following instructions are for updating from 4.6.2.
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.6.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.6.0).
###### 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.4.20
- Date: 2026-06-25
- Version: v4.4.20
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.4.20
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.4.20
- **security** — Update FFmpeg version used in the container image to fix CVE-2026-8461 (critical severity)
> [!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.
This release is made solely to update FFmpeg in our docker container images to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity). It is critical to update if you use our docker container images.
If you are not using our docker container images, please make sure your system FFmpeg is updated to a fixed version, that is, 8.1.2, 7.1.5, 6.1.6, or 5.1.10.
For the recently released v4.4.19, see [4.4.19 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.4.19) 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
###### Security
- Update FFMpeg version used in the container image to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity)
##### Upgrade notes
To get the code for v4.4.20, use `git fetch && git checkout v4.4.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.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.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, it is very important to read the [4.4.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.4.0).
1. Restart all Mastodon processes.
### v4.5.13
- Date: 2026-06-25
- Version: v4.5.13
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.5.13
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.5.13
- **security** — Update FFmpeg version used in the container image to fix CVE-2026-8461 (critical severity)
This release is made solely to update FFmpeg in our docker container images to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity). It is critical to update if you use our docker container images.
If you are not using our docker container images, please make sure your system FFmpeg is updated to a fixed version, that is, 8.1.2, 7.1.5, 6.1.6, or 5.1.10.
For the recently released v4.5.12, see [4.5.12 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.5.12) for information.
##### Changelog
###### Security
- Update FFMpeg version used in the container image to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity)
##### Upgrade notes
To get the code for v4.5.13, use `git fetch && git checkout v4.5.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.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.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.5.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.5.0).
1. Restart all Mastodon processes.
### v4.6.2
- Date: 2026-06-25
- Version: v4.6.2
- Original notes: https://github.com/mastodon/mastodon/releases/tag/v4.6.2
- Permalink: https://whatsnew.fyi/product/mastodon/releases/v4.6.2
- **security** — Update FFmpeg version used in the container image to fix CVE-2026-8461 (critical severity)
This release is made solely to update FFmpeg in our docker container images to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity). It is critical to update if you use our docker container images.
If you are not using our docker container images, please make sure your system FFmpeg is updated to a fixed version, that is, 8.1.2, 7.1.5, 6.1.6, or 5.1.10.
For the recently released v4.6.1, see [4.6.1 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.6.1) for information.
##### Changelog
###### Security
- Update FFMpeg version used in the container image to fix [CVE-2026-8461](https://github.com/advisories/GHSA-qff7-4q6c-m8h6) (critical severity)
##### Upgrade notes
To get the code for v4.6.2, use `git fetch && git checkout v4.6.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.6.0.
- 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
###### Update steps
The following instructions are for updating from 4.6.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.6.0 release notes](https://github.com/mastodon/mastodon/releases/tag/v4.6.0).
1. Restart all Mastodon processes.
