Skip to content

Releases: linuxserver/docker-mastodon

develop-v4.5.0-rc.3-ls135

08 Jan 11:09
3b61202

Choose a tag to compare

Pre-release

CI Report:

N/A

LinuxServer Changes:

Full Changelog: develop-v4.5.0-rc.3-ls134...develop-v4.5.0-rc.3-ls135

Remote Changes:

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

v4.5.5-ls176

20 Jan 16:01
c1fba36

Choose a tag to compare

CI Report:

N/A

LinuxServer Changes:

No changes

Remote Changes:

Mastodon

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

Changed

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

Fixed

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

Upgrade notes

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

Note

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

Dependencies

External dependencies have not changed since v4.5.0.

  • Ruby: 3.2 or newer
  • PostgreSQL: 14 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 7.0 or newer
  • Node: 20.19 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer

Update steps

The following instructions are for updating from 4.5.4.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations. In particular, it is very important to read the 4.5.0 release notes.

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

v4.5.4-ls176

07 Jan 15:04
c1fba36

Choose a tag to compare

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.3-ls175...v4.5.4-ls176

Remote Changes:

Mastodon

Upgrade overview

This release contains upgrade notes that deviate from the norm:

ℹ️ Requires assets recompilation

For more information, view the complete release notes and scroll down to the upgrade instructions section.

Changelog

Security

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

Changed

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

Fixed

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

Upgrade notes

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

Note

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

Dependencies

External dependencies have not changed since v4.5.0.

  • Ruby: 3.2 or newer
  • PostgreSQL: 14 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 7.0 or newer
  • Node: 20.19 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer

Update steps

The following instructions are for updating from 4.5.3.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations. In particular, it is very important to read the 4.5.0 release notes.

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

glitch-v4.5.5-ls315

20 Jan 16:02
414811f

Choose a tag to compare

glitch-v4.5.5-ls315 Pre-release
Pre-release

CI Report:

N/A

LinuxServer Changes:

No changes

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

Security

Changed

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

Fixed

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

Upgrade notes

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

Note

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

Dependencies

External dependencies have not changed since v4.5.0.

  • Ruby: 3.2 or newer
  • PostgreSQL: 14 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 7.0 or newer
  • Node: 20.19 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer

Update steps

The following instructions are for updating from 4.5.4.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations. In particular, it is very important to read the 4.5.0 release notes.

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

glitch-v4.5.4-ls315

07 Jan 15:04
414811f

Choose a tag to compare

glitch-v4.5.4-ls315 Pre-release
Pre-release

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.3-ls314...glitch-v4.5.4-ls315

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

Security

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

Changed

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

Fixed

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

Upgrade notes

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

Note

As always, make sure you have backups of the database before performing any upgrades. If you are using docker-compose, this is how a backup command might look: docker exec mastodon_db_1 pg_dump -Fc -U postgres postgres > name_of_the_backup.dump

Dependencies

External dependencies have not changed since v4.5.0.

  • Ruby: 3.2 or newer
  • PostgreSQL: 14 or newer
  • Elasticsearch (recommended, for full-text search): 7.x (OpenSearch should also work)
  • LibreTranslate (optional, for translations): 1.3.3 or newer
  • Redis: 7.0 or newer
  • Node: 20.19 or newer
  • libvips (optional, instead of ImageMagick): 8.13 or newer
  • ImageMagick (optional if using libvips): 6.9.7-7 or newer

Update steps

The following instructions are for updating from 4.5.3.

If you are upgrading directly from an earlier release, please carefully read the upgrade notes for the skipped releases as well, as they often require extra steps such as database migrations. In particular, it is very important to read the 4.5.0 release notes.

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

v4.5.3-ls175

25 Dec 11:06
1c0686d

Choose a tag to compare

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.3-ls174...v4.5.3-ls175

Remote Changes:

Mastodon

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 inconsistent error handling leaking information on existence of private posts (GHSA-gwhw-gcjx-72v8)

Fixed

  • Fix “Delete and Redraft” on a non-quote being treated as a quote post in some cases (#37140 by @ClearlyClaire)
  • Fix YouTube embeds by sending referer (#37126 by @ChaosExAnima)
  • Fix streamed quoted polls not being hydrated correctly (#37118 by @ClearlyClaire)
  • Fix creation of duplicate conversations (#37108 by @oneiros)
  • Fix extraneous noreferrer in external links (#37107 by @ChaosExAnima)
  • Fix edge case error handling in some database migrations (#37079 by @ClearlyClaire)
  • Fix error handling when re-fetching already-known statuses (#37077 by @ClearlyClaire)
  • Fix post navigation in single-column mode when Advanced UI is enabled (#37044 by @diondiondion)
  • Fix tootctl status remove removing quoted posts and remote quotes of local posts (#37009 by @ClearlyClaire)
  • Fix known expensive S3 batch delete operation failing because of short timeouts (#37004 by @ClearlyClaire)
  • Fix compose autosuggest always lowercasing input token (#36995 by @ClearlyClaire)

Upgrade notes

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

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

glitch-v4.5.3-ls314

25 Dec 11:05
8ebd71a

Choose a tag to compare

glitch-v4.5.3-ls314 Pre-release
Pre-release

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.3-ls313...glitch-v4.5.3-ls314

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

Security

  • Fix inconsistent error handling leaking information on existence of private posts (GHSA-gwhw-gcjx-72v8)

Fixed

  • Fix “Delete and Redraft” on a non-quote being treated as a quote post in some cases (#37140 by @ClearlyClaire)
  • Fix YouTube embeds by sending referer (#37126 by @ChaosExAnima)
  • Fix streamed quoted polls not being hydrated correctly (#37118 by @ClearlyClaire)
  • Fix creation of duplicate conversations (#37108 by @oneiros)
  • Fix extraneous noreferrer in external links (#37107 by @ChaosExAnima)
  • Fix edge case error handling in some database migrations (#37079 by @ClearlyClaire)
  • Fix error handling when re-fetching already-known statuses (#37077 by @ClearlyClaire)
  • Fix post navigation in single-column mode when Advanced UI is enabled (#37044 by @diondiondion)
  • Fix tootctl status remove removing quoted posts and remote quotes of local posts (#37009 by @ClearlyClaire)
  • Fix known expensive S3 batch delete operation failing because of short timeouts (#37004 by @ClearlyClaire)
  • Fix compose autosuggest always lowercasing input token (#36995 by @ClearlyClaire)

Upgrade notes

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

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

develop-v4.5.0-rc.3-ls134

25 Dec 11:04
7e39159

Choose a tag to compare

Pre-release

CI Report:

N/A

LinuxServer Changes:

Full Changelog: develop-v4.5.0-rc.3-ls133...develop-v4.5.0-rc.3-ls134

Remote Changes:

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

v4.5.3-ls174

18 Dec 11:08
3812de5

Choose a tag to compare

CI Report:

N/A

LinuxServer Changes:

Full Changelog: v4.5.3-ls173...v4.5.3-ls174

Remote Changes:

Mastodon

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 inconsistent error handling leaking information on existence of private posts (GHSA-gwhw-gcjx-72v8)

Fixed

  • Fix “Delete and Redraft” on a non-quote being treated as a quote post in some cases (#37140 by @ClearlyClaire)
  • Fix YouTube embeds by sending referer (#37126 by @ChaosExAnima)
  • Fix streamed quoted polls not being hydrated correctly (#37118 by @ClearlyClaire)
  • Fix creation of duplicate conversations (#37108 by @oneiros)
  • Fix extraneous noreferrer in external links (#37107 by @ChaosExAnima)
  • Fix edge case error handling in some database migrations (#37079 by @ClearlyClaire)
  • Fix error handling when re-fetching already-known statuses (#37077 by @ClearlyClaire)
  • Fix post navigation in single-column mode when Advanced UI is enabled (#37044 by @diondiondion)
  • Fix tootctl status remove removing quoted posts and remote quotes of local posts (#37009 by @ClearlyClaire)
  • Fix known expensive S3 batch delete operation failing because of short timeouts (#37004 by @ClearlyClaire)
  • Fix compose autosuggest always lowercasing input token (#36995 by @ClearlyClaire)

Upgrade notes

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

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.

glitch-v4.5.3-ls313

18 Dec 11:08
5e71763

Choose a tag to compare

glitch-v4.5.3-ls313 Pre-release
Pre-release

CI Report:

N/A

LinuxServer Changes:

Full Changelog: glitch-v4.5.3-ls312...glitch-v4.5.3-ls313

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

Security

  • Fix inconsistent error handling leaking information on existence of private posts (GHSA-gwhw-gcjx-72v8)

Fixed

  • Fix “Delete and Redraft” on a non-quote being treated as a quote post in some cases (#37140 by @ClearlyClaire)
  • Fix YouTube embeds by sending referer (#37126 by @ChaosExAnima)
  • Fix streamed quoted polls not being hydrated correctly (#37118 by @ClearlyClaire)
  • Fix creation of duplicate conversations (#37108 by @oneiros)
  • Fix extraneous noreferrer in external links (#37107 by @ChaosExAnima)
  • Fix edge case error handling in some database migrations (#37079 by @ClearlyClaire)
  • Fix error handling when re-fetching already-known statuses (#37077 by @ClearlyClaire)
  • Fix post navigation in single-column mode when Advanced UI is enabled (#37044 by @diondiondion)
  • Fix tootctl status remove removing quoted posts and remote quotes of local posts (#37009 by @ClearlyClaire)
  • Fix known expensive S3 batch delete operation failing because of short timeouts (#37004 by @ClearlyClaire)
  • Fix compose autosuggest always lowercasing input token (#36995 by @ClearlyClaire)

Upgrade notes

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

Non-Docker

Tip

The charlock_holmes gem may fail to build on some systems with recent versions of gcc.
If you run into this issue, try BUNDLE_BUILD__CHARLOCK_HOLMES="--with-cxxflags=-std=c++17" bundle install.

  1. Precompile the assets: RAILS_ENV=production bundle exec rails assets:precompile
  2. Restart all Mastodon processes.

When using Docker

  1. Restart all Mastodon processes.