This is a bugfix release for the 4.2.0 version, if you're installing from an earlier version, please check the 4.2.0 release notes as they contain important information on how to update.

:warning: We recently released important security updates.

If you don't want or can't update to 4.2.x yet, the security updates are also available for the 4.1.x branch, the 4.0.x branch and the 3.5.x branch.

Changelog

Added

• Add redirection on /deck URLs for logged-out users (ClearlyClaire)
• Add support for v4.2.0 migrations to tootctl maintenance fix-duplicates (ClearlyClaire)

Changed

• Change some worker lock TTLs to be shorter-lived (ClearlyClaire)
• Change user archive export allowed period from 7 days to 6 days (suddjian)

Fixed

• Fix clicking on already-opened thread post scrolling to the top of the thread (ClearlyClaire, ClearlyClaire)
• Fix some remote posts getting truncated (ClearlyClaire)
• Fix some cases of infinite scroll code trying to fetch inaccessible posts in a loop (ClearlyClaire)
• Fix Vary headers not being set on some redirects (ClearlyClaire)
• Fix mentions being matched in some URL query strings (mjankowski)
• Fix unexpected linebreak in version string in the Web UI (vmstan)
• Fix double scroll bars in some columns in advanced interface (ClearlyClaire)
• Fix boosts of local users being filtered in account timelines (ClearlyClaire)
• Fix multiple instances of the trend refresh scheduler sometimes running at once (ClearlyClaire)
• Fix importer returning negative row estimates (jgillich)
• Fix incorrectly keeping outdated update notices absent from the API endpoint (ClearlyClaire)
• Fix import progress not updating on certain failures (ClearlyClaire)
• Fix websocket connections being incorrectly decremented twice on errors (ThisIsMissEm)
• Fix explore prompt appearing because of posts being received out of order (ClearlyClaire)
• Fix explore prompt sometimes showing up when the home TL is loading (ClearlyClaire)
• Fix link handling of mentions in user profiles when logged out (ClearlyClaire)
• Fix filtering audit log for entries about disabling 2FA (ClearlyClaire)
• Fix notification toasts not respecting reduce-motion (c960657)
• Fix retention dashboard not displaying correct month (vmstan)
• Fix tIME chunk not being properly removed from PNG uploads (TheEssem)
• Fix division by zero in video in bitrate computation code (ClearlyClaire)
• Fix inefficient queries in “Follows and followers” as well as several admin pages (ClearlyClaire, ClearlyClaire)
• Fix ActiveRecord using two connection pools when no replica is defined (ClearlyClaire)
• Fix the search documentation URL in system checks (renchap)

Upgrade notes

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

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

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

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.2.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.

Non-Docker only:

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

Using Docker:

1. Restart all Mastodon processes

:warning: We recently released important security updates, so if you are still using a 4.2.0 pre-release, 4.1.7 or below, 4.0.9 or below, or 3.5.13 or below, please update as soon as possible (see the release notes for v4.1.8).

Changelog

Changed

• Change some worker lock TTLs to be shorter-lived (ClearlyClaire)
• Change user archive export allowed period from 7 days to 6 days (suddjian)

Fixed

• Fix mentions being matched in some URL query strings (mjankowski)
• Fix multiple instances of the trend refresh scheduler sometimes running at once (ClearlyClaire)
• Fix importer returning negative row estimates (jgillich)
• Fix filtering audit log for entries about disabling 2FA (ClearlyClaire)
• Fix tIME chunk not being properly removed from PNG uploads (TheEssem)
• Fix inefficient queries in “Follows and followers” as well as several admin pages (ClearlyClaire, ClearlyClaire)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.1.9.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

:warning: The 4.0.x branch will not receive any update—including security fixes—after 2023-10-31.

:warning: We recently released important security updates, so if you are still using a 4.2.0 pre-release, 4.1.7 or below, 4.0.9 or below, or 3.5.13 or below, please update as soon as possible (see the release notes for v4.0.10).

End of life notice

The 4.0.x branch will not receive any update after 2023-10-31. This means that no security fix will be made available for this branch after this date, and you will need to update to a more recent version (such as the 4.1.x branch) to receive security fixes.

Changelog

Changed

• Change some worker lock TTLs to be shorter-lived (ClearlyClaire)
• Change user archive export allowed period from 7 days to 6 days (suddjian)

Fixed

• Fix mentions being matched in some URL query strings (mjankowski)
• Fix multiple instances of the trend refresh scheduler sometimes running at once (ClearlyClaire)
• Fix importer returning negative row estimates (jgillich)
• Fix filtering audit log for entries about disabling 2FA (ClearlyClaire)
• Fix tIME chunk not being properly removed from PNG uploads (TheEssem)
• Fix inefficient queries in “Follows and followers” as well as several admin pages (ClearlyClaire, ClearlyClaire)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.0.11.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

:warning: The 3.5.x branch will not receive any update—including security fixes—after 2023-12-31.

:warning: We recently released important security updates, so if you are still using a 4.2.0 pre-release, 4.1.7 or below, 4.0.9 or below, or 3.5.13 or below, please update as soon as possible (see the release notes for v3.5.14).

End of life notice

The 3.5.x branch will not receive any update after 2023-12-31. This means that no security fix will be made available for this branch after this date, and you will need to update to a more recent version (such as the 4.1.x branch) to receive security fixes.

Changelog

Changed

• Change user archive export allowed period from 7 days to 6 days (suddjian)

Fixed

• Fix mentions being matched in some URL query strings (mjankowski)
• Fix importer returning negative row estimates (jgillich)
• Fix filtering audit log for entries about disabling 2FA (ClearlyClaire)
• Fix tIME chunk not being properly removed from PNG uploads (TheEssem)
• Fix inefficient queries in “Follows and followers” as well as several admin pages (ClearlyClaire, ClearlyClaire)

Upgrade notes

To get the code for v3.5.15, use git fetch && git checkout v3.5.15.

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 12.22, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 3.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.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

This release addresses an issue that was introduced by the last security update and includes changelogs for both updates.

:warning: This is a follow-up to the important 4.1.8 security update that fixed major security issues (CVE-2023-42451, CVE-2023-42452).

Corresponding security releases are available for the 4.0.x branch and the 3.5.x branch. If you are using nightly builds, do not use this release but update to nightly.2023-09-20 or newer instead. If you are on the main branch, update to the latest commit.

Changelog (v4.1.9)

Fixed

• Fix post translation erroring out (ClearlyClaire)

Changelog (v4.1.8)

Fixed

• Fix post edits not being forwarded as expected (ClearlyClaire)
• Fix moderator rights inconsistencies (ClearlyClaire)
• Fix crash when encountering invalid URL (ClearlyClaire)
• Fix cached posts including stale stats (ClearlyClaire)
• Fix uploading of video files for which ffprobe reports 0/0 average framerate (NicolaiSoeborg)
• Fix unexpected audio stream transcoding when uploaded video is eligible to passthrough (yufushiro)

Security

• Fix missing HTML sanitization in translation API (CVE-2023-42452, GHSA-2693-xr3m-jhqr)
• Fix incorrect domain name normalization (CVE-2023-42451, GHSA-v3xf-c9qf-j667)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.1.7 or 4.1.8.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

:warning: The 4.0.x branch will not receive any update—including security fixes—after 2023-10-31.

This release addresses an issue that was introduced by the last security update and includes changelogs for both updates.

:warning: This is a follow-up to the important 4.0.10 security update that fixed major security issues (CVE-2023-42451, CVE-2023-42452).

Corresponding security releases are available for the 4.1.x branch and the 3.5.x branch.

End of life notice

The 4.0.x branch will not receive any update after 2023-10-31. This means that no security fix will be made available for this branch after this date, and you will need to update to a more recent version (such as the 4.1.x branch) to receive security fixes.

Changelog (v4.0.11)

Fixed

• Fix post translation erroring out (ClearlyClaire)

Changelog (v4.0.10)

Fixed

• Fix moderator rights inconsistencies (ClearlyClaire)
• Fix crash when encountering invalid URL (ClearlyClaire)
• Fix cached posts including stale stats (ClearlyClaire)
• Fix uploading of video files for which ffprobe reports 0/0 average framerate (NicolaiSoeborg)
• Fix unexpected audio stream transcoding when uploaded video is eligible to passthrough (yufushiro)

Security

• Fix missing HTML sanitization in translation API (CVE-2023-42452, GHSA-2693-xr3m-jhqr)
• Fix incorrect domain name normalization (CVE-2023-42451, GHSA-v3xf-c9qf-j667)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.0.9 or 4.0.10.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

:warning: This release is an important security release fixing major security issues (CVE-2023-42451, CVE-2023-42452).

Corresponding security releases are available for the 4.0.x branch and the 3.5.x branch. If you are using nightly builds, do not use this release but update to nightly.2023-09-20 or newer instead. If you are on the main branch, update to the latest commit.

Changelog

Fixed

• Fix post edits not being forwarded as expected (ClearlyClaire)
• Fix moderator rights inconsistencies (ClearlyClaire)
• Fix crash when encountering invalid URL (ClearlyClaire)
• Fix cached posts including stale stats (ClearlyClaire)
• Fix uploading of video files for which ffprobe reports 0/0 average framerate (NicolaiSoeborg)
• Fix unexpected audio stream transcoding when uploaded video is eligible to passthrough (yufushiro)

Security

• Fix missing HTML sanitization in translation API (CVE-2023-42452, GHSA-2693-xr3m-jhqr)
• Fix incorrect domain name normalization (CVE-2023-42451, GHSA-v3xf-c9qf-j667)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.1.7.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes

:warning: The 4.0.x branch will not receive any update—including security fixes—after 2023-10-31.

:warning: This release is an important security release fixing major security issues (CVE-2023-42451, CVE-2023-42452).

Corresponding security releases are available for the 4.1.x branch and the 3.5.x branch. If you are using nightly builds, do not use this release but update to nightly.2023-09-20 or newer instead. If you are on the main branch, update to the latest commit.

End of life notice

The 4.0.x branch will not receive any update after 2023-10-31. This means that no security fix will be made available for this branch after this date, and you will need to update to a more recent version (such as the 4.1.x branch) to receive security fixes.

Changelog

Fixed

• Fix moderator rights inconsistencies (ClearlyClaire)
• Fix crash when encountering invalid URL (ClearlyClaire)
• Fix cached posts including stale stats (ClearlyClaire)
• Fix uploading of video files for which ffprobe reports 0/0 average framerate (NicolaiSoeborg)
• Fix unexpected audio stream transcoding when uploaded video is eligible to passthrough (yufushiro)

Security

• Fix missing HTML sanitization in translation API (CVE-2023-42452, GHSA-2693-xr3m-jhqr)
• Fix incorrect domain name normalization (CVE-2023-42451, GHSA-v3xf-c9qf-j667)

Upgrade notes

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

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

• Ruby: 2.7 to 3.0
• PostgreSQL: 9.5 or newer
• Elasticsearch (optional, for full-text search): 7.x
• Redis: 4 or newer
• Node: >= 14, < 18
• ImageMagick: 6.9.7-7 or newer

If your uploaded images are broken after the upgrade, it means your installed ImageMagick version is older than the new minimum version (6.9.7-7), for example if you are running Ubuntu 18.04. If this happens, you can find more information and ways to fix it on this page.

Update steps

The following instructions are for updating from 4.0.9.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations.

Non-Docker only:

1. Install dependencies: bundle install and yarn install --frozen-lockfile

Both Docker and non-Docker:

1. Restart all Mastodon processes