Releases: mastodon/mastodon
v4.1.0rc1
Note: This is a release candidate. It is intended to be stable, but not guaranteed.
Changelog
Added
- Add support for importing/exporting server-wide domain blocks (enbylenore, ClearlyClaire, dariusk, ClearlyClaire)
- Add listing of followed hashtags (connorshea)
- Add support for editing media description and focus point of already-sent posts (ClearlyClaire)
- Add follow request banner on account header (ClearlyClaire)
- Add confirmation screen when handling reports (ClearlyClaire, Gargron)
- Add option to make the landing page be
/about
even when trends are enabled (ClearlyClaire) - Add
noindex
setting back to the admin interface (prplecake) - Add instance peers API endpoint toggle back to the admin interface (dariusk)
- Add instance activity API endpoint toggle back to the admin interface (dariusk)
- Add
account.approved
webhook (Saiv46) - Add 12 hours option to polls (Pleclown)
- Add dropdown menu item to open admin interface for remote domains (ClearlyClaire)
- Add
--remove-headers
,--prune-profiles
and--include-follows
flags totootctl media remove
(evanphilip) - Add
--email
and--dry-run
options totootctl accounts delete
(ClearlyClaire) - Add
tootctl accounts migrate
(ClearlyClaire) - Add
tootctl accounts prune
(tribela) - Add
tootctl domains purge
(ClearlyClaire) - Add
SIDEKIQ_CONCURRENCY
environment variable (muffinista) - Add
MIN_THREADS
environment variable to set minimum Puma threads (jimeh) - Add explanation text to log-in page (ClearlyClaire)
- Add user profile OpenGraph tag on post pages (bramus)
- Add maskable icon support for Android (workeffortwaste)
- Add Belarusian to supported languages (Mixaill)
- Add Western Frisian to supported languages (ykzts)
- Add Montenegrin to the language picker (ayefries)
- Add Southern Sami and Lule Sami to the language picker (Jullan-M)
- Add logging for Rails cache timeouts (ClearlyClaire)
- Add color highlight for active hashtag “follow” button (MFTabriz)
- Add brotli compression to
assets:precompile
(Izorkin) - Add “disabled” account filter to the
/admin/accounts
UI (tribela) - Add transparency to modal background for accessibility (edent)
- Add
title
attribute to video elements in media attachments (bramus) - Add left and right margins to emojis (dsblank)
- Add
reading:autoplay:gifs
to/api/v1/preferences
(j-f1) - Add
hide_collections
parameter to/api/v1/accounts/credentials
(CarlSchwan) - Add more specific error messages to HTTP signature verification (ClearlyClaire)
- Add Storj DCS to cloud object storage options in the
mastodon:setup
rake task (jtolio) - Add checkmark symbol in the checkbox for sensitive media (sidp)
- Add missing accessibility attributes to logout link in modals (kytta)
- Add missing accessibility attributes to “Hide image” button in
MediaGallery
(hs4man21) - Add missing accessibility attributes to hide content warning field when disabled (hs4man21)
- Add
aria-hidden
to footer circle dividers to improve accessibility (hs4man21)
Changed
- Ensure exact match is the first result in hashtag searches (ClearlyClaire)
- Change account search to return followed accounts first (dariusk)
- Change batch account suspension to create a strike (ClearlyClaire)
- Change default reply language to match the default language when replying to a translated post (ClearlyClaire)
- Change misleading wording about waitlists (ClearlyClaire)
- Increase width of the unread notification border (connorshea)
- Change new post notification button on profiles to make it more apparent when it is enabled (tribela)
- Change trending tags admin interface to always show batch action controls (ClearlyClaire)
- Change wording of some OAuth scope descriptions (ClearlyClaire)
- Change wording of admin report handling actions (ClearlyClaire)
- Change confirm prompts for relationships management (tribela)
- Change language surrounding disability in prompts for media descriptions (hs4man21)
- Change confusing wording in the sign in banner (ClearlyClaire)
- Change account moderation notes to make links clickable (ClearlyClaire)
- Save avatar or header correctly even if the other one fails (tribela)
- Change
referrer-policy
tosame-origin
application-wide (ClearlyClaire, ClearlyClaire) - Add 'private' to
Cache-Control
, match Rails expectations (daxtens) - Make the button that expands the compose form differentiable from the button that publishes a post (Tak)
- Change automatic post deletion configuration to be accessible to moved users (ClearlyClaire)
- Make tag following idempotent (trwnh, ClearlyClaire)
- Use buildx functions for faster builds (inductor)
- Split off Dockerfile components for faster builds (moritzheiber, ineffyble, BtbN)
- Change last occurrence of “silence” to “limit” in UI text (cincodenada)
- Change “hide toot” to “hide post” (seanthegeek)
- Don't allow URLs that contain non-normalized paths to be verified (dgl)
- Change the “Trending now” header to be a link to the Explore page (connorshea)
- Change PostgreSQL connection timeout from 2 minutes to 15 seconds (ClearlyClaire)
- Make handle more easily selectable on profile page (cadars)
- Allow admins to refresh remotely-suspended accounts (ClearlyClaire)
- Change dropdown menu to contain “Copy link to post” even for non-public posts (ClearlyClaire)
- Allow adding relays in secure mode and limited federation mode (ineffyble)
- Change timestamps to be displayed using the user's timez...
v4.0.2
Changelog
Fixed
- Fix wrong color on mentions hidden behind content warning in web UI (Gargron)
- Fix filters from other users being used in the streaming service (ClearlyClaire)
- Fix
unsafe-eval
being used whenwasm-unsafe-eval
is enough in Content Security Policy (Gargron, prplecake)
Upgrade notes
To get the code for v4.0.2, use git fetch && git checkout v4.0.2
.
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
Update steps
The following instructions are for updating from 4.0.0 or 4.0.1.
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. You can use the 4.0.0 upgrade notes to upgrade directly to 4.0.2.
Non-Docker only:
- Install dependencies:
bundle install
Both Docker and non-Docker:
- Precompile the assets:
- Non-Docker:
RAILS_ENV=production bundle exec rails assets:precompile
- Docker: The assets are already precompiled during the build step
- Non-Docker:
- Restart all Mastodon processes
v4.0.1
v4.0.0
Upgrade overview
This release contains upgrade notes that deviate from the norm:
ℹ️ Requires two-step database migration process for zero-downtime deployment
ℹ️ Some migrations may take a long time to run
ℹ️ Behaviour of AUTHORIZED_FETCH
changed
ℹ️ Requires review of Sidekiq queues in some setups (new queue: ingress
)
ℹ️ Some server settings, like thumbnail, short description, and so on, changed and may need to be looked at
For more information, scroll down to the upgrade instructions section.
Changelog
Some of the features in this release have been funded through the NGI0 Discovery Fund, a fund established by NLnet with financial support from the European Commission's Next Generation Internet programme, under the aegis of DG Communications Networks, Content and Technology under grant agreement No 825322.
Added
- Add ability to filter followed accounts' posts by language (Gargron, ClearlyClaire)
- Add ability to follow hashtags (Gargron, Gargron, Gargron, noellabo)
- Add ability to filter individual posts (ClearlyClaire)
- Add ability to translate posts (Gargron, ClearlyClaire, Gargron, ClearlyClaire, Gargron, ykzts, Gargron)
- Add featured tags to web UI (noellabo, noellabo, noellabo, noellabo, Gargron, ykzts, noellabo, noellabo, Gargron, Gargron, ClearlyClaire)
- Add support for language preferences for trending statuses and links (Gargron, Gargron, ykzts)
- Previously, you could only see trends in your current language
- For less popular languages, that meant empty trends
- Now, trends in your preferred languages' are shown on top, with others beneath
- Add server rules to sign-up flow (Gargron)
- Add privacy icons to report modal in web UI (ClearlyClaire)
- Add
noopener
to links to remote profiles in web UI (shleeable) - Add option to open original page in dropdowns of remote content in web UI (Gargron)
- Add warning for sensitive audio posts in web UI (rgroothuijsen)
- Add language attribute to posts in web UI (tribela)
- Add support for uploading WebP files (Saiv46)
- Add support for uploading
audio/vnd.wave
files (tribela) - Add support for uploading AVIF files (txt-file)
- Add support for uploading HEIC files (Gargron)
- Add more debug information when processing remote accounts (ClearlyClaire, ClearlyClaire)
- Add retention policy for cached content and media (Gargron, zunda, Gargron, Gargron)
- Set for how long remote posts or media should be cached on your server
- Hands-off alternative to
tootctl
commands
- Add customizable user roles (Gargron, ClearlyClaire, Gargron, tribela, tribela, ClearlyClaire, ClearlyClaire, unextro, tribela, ClearlyClaire)
- Previously, there were 3 hard-coded roles, user, moderator, and admin
- Create your own roles and decide which permissions they should have
- Add notifications for new reports (Gargron, Gargron)
- Add ability to select all accounts matching search for batch actions in admin UI (Gargron, Gargron)
- Add ability to view previous edits of a status in admin UI (Gargron)
- Add ability to block sign-ups from IP (Gargron)
- Add webhooks to admin UI (Gargron)
- Add admin API for managing domain allows (ClearlyClaire)
- Add admin API for managing domain blocks (ClearlyClaire)
- Add admin API for managing e-mail domain blocks (Gargron)
- Add admin API for managing canonical e-mail blocks (Gargron)
- Add admin API for managing IP blocks (Gargron, trwnh)
- Add
sensitized
attribute to accounts in admin REST API (trwnh) - Add
services
andmetadata
to the NodeInfo endpoint (MFTabriz) - Add
--remove-role
option totootctl accounts modify
(Gargron) - Add
--days
option totootctl media refresh
(tribela) - Add
EMAIL_DOMAIN_LISTS_APPLY_AFTER_CONFIRMATION
environment variable (ClearlyClaire) - Add
IP_RETENTION_PERIOD
andSESSION_RETENTION_PERIOD
environment variables (kescherCode) - Add
http_hidden_proxy
environment variable (tribela) - Add
SMTP_ENABLE_STARTTLS
environment variable (erbridge) - Add caching for payload serialization during fan-out (ClearlyClaire, Gargron, ClearlyClaire, ClearlyClaire, ClearlyClaire)
- Add assets from Twemoji 14.0 (Gargron)
- Add reputation and followers score boost to SQL-only account search (Gargron)
- Add Scots, Balaibalan, Láadan, Lingua Franca Nova, Lojban, Toki Pona to languages list (VyrCossont)
- Set autocomplete hints for e-mail, password and OTP fields (rcombs, offbyone, ClearlyClaire)
- Add support for DigitalOcean Spaces in setup wizard (v-aisac)
Changed
- Change brand color and logotypes (Gargron, Gargron, Gargron, ClearlyClaire, Gargron, mayaeh)
- Change post editing to be enabled in web UI (Gargron)
- Change web UI to work for logged-out users ([Gargron](https://github.co...
v4.0.0rc4
Note: This is a release candidate. It is intended to be stable, but not guaranteed.
For all notes, see v4.0.0rc1. This update includes a variety of fixes and improvements. Upgrading from v4.0.0rc3 requires a code update, assets precompilation, and a web process reload/restart.
v3.5.5
This is a backport for the 3.5.x branch.
Changelog
Fixed
- Fix nodes order being sometimes mangled when rewriting emoji (ClearlyClaire)
Upgrade notes
Because this is a backport, it is not available with git pull
. Use git fetch && git checkout v3.5.5
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.3, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:
- Ruby: 2.6 to 3.0
- PostgreSQL: 9.5 or newer
- Elasticsearch (optional, for full-text search): 7.x
- Redis: 4 or newer
- Node: 12.22 or newer
Update steps
The following instructions are for updating from 3.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 or dependency updates.
Non-Docker
- Pull the code:
git fetch && git checkout v3.5.5
- Rebuild assets:
RAILS_ENV=production bundle exec rails assets:precompile
- Restart
mastodon-web
andmastodon-sidekiq
:
systemctl reload mastodon-web
systemctl restart mastodon-sidekiq
Docker
The exact steps depend on your setup, but they are likely to match the following:
- Pull the code:
git fetch && git checkout v3.5.5
- Pull the prebuilt images:
docker-compose pull
, or, alternatively, build them yourself:docker-compose build --pull
- Restart all Mastodon processes:
docker-compose up -d
v3.5.4
This is a backport for the 3.5.x branch.
Changelog
Fixed
- Fix error when a remote report includes a private post the server has no access to (ClearlyClaire)
Security
- Fix emoFix emoji substitution not applying only to text nodes in backend code (ClearlyClaire)
- Fix emoji substitution not applying only to text nodes in Web UI (ClearlyClaire)
- Fix rate limiting for paths with formats (Gargron)
- Fix out-of-bound reads in blurhash transcoder (delroth)
Upgrade notes
Because this is a backport, it is not available with git pull
. Use git fetch && git checkout v3.5.4
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.3, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:
- Ruby: 2.6 to 3.0
- PostgreSQL: 9.5 or newer
- Elasticsearch (optional, for full-text search): 7.x
- Redis: 4 or newer
- Node: 12.22 or newer
Update steps
The following instructions are for updating from 3.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 or dependency updates.
Non-Docker
- Pull the code:
git fetch && git checkout v3.5.4
- Rebuild assets:
RAILS_ENV=production bundle exec rails assets:precompile
- Restart
mastodon-web
andmastodon-sidekiq
:
systemctl reload mastodon-web
systemctl restart mastodon-sidekiq
Docker
The exact steps depend on your setup, but they are likely to match the following:
- Pull the code:
git fetch && git checkout v3.5.4
- Pull the prebuilt images:
docker-compose pull
, or, alternatively, build them yourself:docker-compose build --pull
- Restart all Mastodon processes:
docker-compose up -d
v3.4.10
This is a backport for the 3.4.x branch.
Changelog
Fixed
- Fix nodes order being sometimes mangled when rewriting emoji (ClearlyClaire)
Upgrade notes
Because this is a backport, it is not available with git pull
. Use git fetch && git checkout v3.4.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 v3.4.7, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:
- Ruby: 2.6 to 3.0
- PostgreSQL: 9.5 or newer
- Elasticsearch (optional, for full-text search): 5.x, 6.x or 7.x
- Redis: 4 or newer
- Node: 12.22 or higher
Update steps
The following instructions are for updating from 3.4.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 or dependency updates.
Non-Docker
- Pull the code:
git fetch && git checkout v3.4.10
- Rebuild assets:
RAILS_ENV=production bundle exec rails assets:precompile
- Restart
mastodon-web
andmastodon-sidekiq
:
systemctl reload mastodon-web
systemctl restart mastodon-sidekiq
Docker
The exact steps depend on your setup, but they are likely to match the following:
- Pull the code:
git fetch && git checkout v3.4.10
- Pull the prebuilt images:
docker-compose pull
, or, alternatively, build them yourself:docker-compose build --pull
- Restart all Mastodon processes:
docker-compose up -d
v3.4.9
This is a backport for the 3.4.x branch.
Changelog
Security
- Fix emoji substitution not applying only to text nodes in backend code (ClearlyClaire)
- Fix emoji substitution not applying only to text nodes in Web UI (ClearlyClaire)
- Fix rate limiting for paths with formats (Gargron)
- Fix out-of-bound reads in blurhash transcoder (delroth)
Upgrade notes
Because this is a backport, it is not available with git pull
. Use git fetch && git checkout v3.4.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 v3.4.7, the compatible Ruby, PostgreSQL, Node, Elasticsearch and Redis versions are the same, that is:
- Ruby: 2.6 to 3.0
- PostgreSQL: 9.5 or newer
- Elasticsearch (optional, for full-text search): 5.x, 6.x or 7.x
- Redis: 4 or newer
- Node: 12.22 or higher
Update steps
The following instructions are for updating from 3.4.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 or dependency updates.
Non-Docker
- Pull the code:
git fetch && git checkout v3.4.9
- Rebuild assets:
RAILS_ENV=production bundle exec rails assets:precompile
- Restart
mastodon-web
andmastodon-sidekiq
:
systemctl reload mastodon-web
systemctl restart mastodon-sidekiq
Docker
The exact steps depend on your setup, but they are likely to match the following:
- Pull the code:
git fetch && git checkout v3.4.9
- Pull the prebuilt images:
docker-compose pull
, or, alternatively, build them yourself:docker-compose build --pull
- Restart all Mastodon processes:
docker-compose up -d
v4.0.0rc3
Note: This is a release candidate. It is intended to be stable, but not guaranteed.
Upgrade overview
This release contains upgrade notes that deviate from the norm:
ℹ️ Requires two-step database migration process for zero-downtime deployment
ℹ️ Some migrations may take a long time to run
ℹ️ Behaviour of AUTHORIZED_FETCH
changed
ℹ️ Requires review of Sidekiq queues in some setups. This also applies to updating from v4.0.0rc2
For more information, scroll down to the upgrade instructions section.
Changelog
TBD. This update includes a variety of fixes and improvements on top of v4.0.0rc1.
Upgrade notes
To get the code for v4.0.0rc3, use git fetch && git checkout v4.0.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
Update steps
The following instructions are for updating from 3.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.
Non-Docker only:
- The recommended Ruby version has been bumped to 3.0.4. You can upgrade, or you can continue using the old version by overwriting the
.ruby-version
file with e.g.3.0.3
which was recommended previously - Install dependencies:
bundle install
andyarn install
Both Docker and non-Docker:
⚠️ Incoming federated activity now uses a newingress
queue in Sidekiq. If you customize Sidekiq processes/queues, ensure that there is at least one process handling theingress
queue.
- Run the pre-deployment database migrations by specifying the
SKIP_POST_DEPLOYMENT_MIGRATIONS=true
environment variable:- Non-Docker:
SKIP_POST_DEPLOYMENT_MIGRATIONS=true RAILS_ENV=production bundle exec rails db:migrate
- Docker:
docker-compose run --rm -e SKIP_POST_DEPLOYMENT_MIGRATIONS=true web rails db:migrate
- Non-Docker:
- Precompile the assets:
- Non-Docker:
RAILS_ENV=production bundle exec rails assets:precompile
- Docker: The assets are already precompiled during the build step
- Non-Docker:
- Restart all Mastodon processes
- Now that the new code is running, we can finish the database migrations. This will run the post-deployment ones:
- Non-Docker:
RAILS_ENV=production bundle exec rails db:migrate
- Docker:
docker-compose run --rm web rails db:migrate
- Non-Docker:
- Restart all Mastodon processes
For all notes, see v4.0.0rc1. This update includes a variety of fixes and improvements. Upgrading from v4.0.0rc1 requires a code update, assets precompilation, and a web process reload/restart.