Note: This is a release candidate. It is intended to be stable, but not guaranteed.

Changelog

For changes since v4.0.2, see the CHANGELOG.

Added

• Add roles attribute to Account entities in REST API (ClearlyClaire)
• Add lang attribute to image description textarea and poll option field (c960657)

Changed

• Change notifications per page from 15 to 40 in REST API (Gargron)
• Change number of stored items in home feed from 400 to 800 (Gargron)
• Change API rate limits from 300/5min per user to 1500/5min per user, 300/5min per app (Gargron)
• Change POST /settings/applications/:id to regenerate token on scopes change (ClearlyClaire)
• Change link previews for statuses to never use avatar as fallback (Gargron)

Removed

• Remove intersection-observer polyfill for old Safari support (shuuji3)

Fixed

• Fix styling of featured tags in light theme (ClearlyClaire)
• Fix unserialized role on account entities in admin API (Gargron)
• Fix /share form not getting focus on page load (Akkiesoft)
• Fix incorrect link in push notifications for some event types (elizabeth-dev)

Upgrade notes

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

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.2, 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 or higher

Update steps

The following instructions are for updating from 4.0.2, 4.1.0rc1 or 4.1.0rc2.

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:

• Install dependencies: bundle install and yarn install

Both Docker and non-Docker:

1. Run the database migrations:
   • Non-Docker: RAILS_ENV=production bundle exec rails db:migrate
   • Docker: docker-compose run --rm web rails db:migrate
2. Precompile the assets:
   • Non-Docker: RAILS_ENV=production bundle exec rails assets:precompile
   • Docker: The assets are already precompiled during the build step
3. Restart all Mastodon processes