Mastodon logo

Mastodon

Your self-hosted, globally interconnected microblogging community

Alternative to: Twitter/X, Threads


About Versions (100)

v4.2.14

2024-12-03

Mastodon

Changelog

Added

  • Add tootctl feeds vacuum (#33065 by @ClearlyClaire)

Fixed

  • Fix inactive users’ timelines being backfilled on follow and unsuspend (#33094 by @ClearlyClaire)
  • Fix direct inbox delivery pushing posts into inactive followers’ timelines (#33067 by @ClearlyClaire)
  • Fix TagFollow records not being correctly handled in account operations (#33063 by @ClearlyClaire)
  • Fix pushing hashtag-followed posts to feeds of inactive users (#33018 by @Gargron)
  • Fix and improve batch attachment deletion handling when using OpenStack Swift (#32637 by @hugogameiro)
  • Fix tl language native name (#32606 by @seav)

Upgrade notes

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

[!IMPORTANT] Since v4.2.10, Mastodon is now performing stricter checks to prevent client IP address spoofing. This means that if one of your reverse proxy is not on Mastodon’s local network, you will need to set TRUSTED_PROXY_IP accordingly, listing the IP address of every trusted reverse-proxy (including local network ones). See the documentation for more information.

Dependencies

With the exception of Ruby’s recommended version, 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

Update steps

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

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

Non-Docker only:

  1. Install dependencies: bundle install and yarn install --frozen-lockfile
  2. Restart all Mastodon processes

Using Docker:

  1. Restart all Mastodon processes