[!WARNING] This release is an important security release fixing a major security issue.

A corresponding security release is available for the 4.2.x branch.

Changelog

Security

• Fix incorrect permission checking on multiple API endpoints (GHSA-58x8-3qxw-6hm7)
• Fix incorrect authorship checking when processing some activities (CVE-2024-37903, GHSA-xjvf-fm67-4qc3)
• Fix ongoing streaming sessions not being invalidated when application tokens get revoked (GHSA-vp5r-5pgw-jwqx)
• Update dependencies

Changed

• Change preview cards generation to skip unusually long URLs (oneiros)
• Change search modifiers to be case-insensitive (Gargron)
• Change STATSD_ADDR handling to emit a warning rather than crashing if the address is unreachable (timothyjrogers)
• Change PWA start URL from /home to / (ClearlyClaire)

Fixed

• Fix scheduled statuses scheduled in less than 5 minutes being immediately published (danielmbrasil)
• Fix encoding detection for link cards (oneiros)
• Fix /admin/accounts/:account_id/statuses/:id for edited posts with media attachments (ClearlyClaire)

Upgrade notes

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

[!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] 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

[!WARNING] The minimum required Ruby version has been bumped to 3.0 in Mastodon v4.1.14.

External dependencies have not changed compared to v4.1.14, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:

• Ruby: 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

Update steps

The following instructions are for updating from 4.1.17.

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