You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We now have releases, so this document is less relevant, but I will still try to maintain it somewhat up-to-date.
Releases should be fully documented, and if you want to stick to main instead, you should pay some attention to the changes.
You can assume that any update to main may require running both pre-deployment and post-deployment database migrations, as well as require rebuilding the assets. Those do not constitute breaking changes.
Likewise, the .ruby-version can change at any point without that being considered a breaking change. This means that if you use rbenv, you should do rbenv install after updating the repository. Changes in the required versions of Ruby are considered breaking changes.
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.
Minimum Ruby version has been bumped from 3.0 to 3.1.
In addition, Mastodon requires new environment variables for secret keys to be set.
Generate new secrets and set ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY, ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT, and ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY accordingly before restarting Mastodon.
(Such secrets can be generated by running bin/rails db:encryption:init).
Significant changes have been made to glitch-soc's theming system, which will likely affect forks and flavour authors (but skin authors, end-users, and admins that have made no change to their instance should be unaffected). More details at #2697
Logging format of the streaming server changed for a structured JSON format. This doesn't require changes unless you parse/monitor those logs.
The recommended Ruby version has changed from 3.2.2 to 3.2.3. If you are using rbenv, update the list of available versions and install Ruby 3.2.3 by doing RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install in the Mastodon install directory (e.g. /home/mastodon/live).
Fontawesome icons have been replaced by Material Symbols. This should not require any action from server admins, but this will likely disrupt downstreams and user styles.
fr-QC has been changed to fr-CA, this shouldn't cause issues if the migrations run correctly, but this could affect forks if they have their own translations.
The follow recommendation algorithm changed. For the Elasticsearch-based ones to work properly, accounts need to be re-indexed with tootctl search deploy --only=accounts
Cookies and Rails cache format have changed. Zero-downtime rolling upgrades should be possible if you have already updated recently. Otherwise, stopping all services then starting them. See mastodon#27393 and mastodon#27392
Last commit before the change: 3d3fa75
Last commit without known significant bugs before the change: 1885637 (bug is #2529
minimum NodeJS version changed from NodeJS 16 to NodeJS 18
switched from yarn 1 to yarn 4, the switch should be transparent if you use corepack, otherwise you'll have to either install yarn 4 or enable corepack
The text was updated successfully, but these errors were encountered:
We now have releases, so this document is less relevant, but I will still try to maintain it somewhat up-to-date.
Releases should be fully documented, and if you want to stick to
main
instead, you should pay some attention to the changes.You can assume that any update to
main
may require running both pre-deployment and post-deployment database migrations, as well as require rebuilding the assets. Those do not constitute breaking changes.Likewise, the
.ruby-version
can change at any point without that being considered a breaking change. This means that if you userbenv
, you should dorbenv install
after updating the repository. Changes in the required versions of Ruby are considered breaking changes.2024-11-06 - bf454e9 (#2892)
Dropped support for Ruby 3.1.
2024-08-24 - 49671fe (#2824)
Dropped support for StatsD integration.
2024-05-30 - 2a34c9a (#2721)
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.2024-05-02 - e7b0948 (#2699)
Last commit before the change: 3024212
Minimum Ruby version has been bumped from 3.0 to 3.1.
In addition, Mastodon requires new environment variables for secret keys to be set.
Generate new secrets and set
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY
,ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT
, andACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY
accordingly before restarting Mastodon.(Such secrets can be generated by running
bin/rails db:encryption:init
).2024-04-30 - 6f74ede (#2697)
Last commit before the change: 113c931
Significant changes have been made to glitch-soc's theming system, which will likely affect forks and flavour authors (but skin authors, end-users, and admins that have made no change to their instance should be unaffected). More details at #2697
2024-02-24 - 78c92c0 (#2647)
Last commit before the change: 25ac55e
Registrations are now closed by default! Also, removed
max_toot_chars
from the initial state rendering, but that should not affect anything.2024-02-24 - 25ac55e (#2644)
Last commit before the change: f254140
The composer redesign from upstream has landed, along with CSS and translatable string changes. The doodle feature is temporarily unavailable.
2024-02-12 - 084d051 (#2608)
Branch with the 2024-02-14 security fixes: glitch-soc/security/8c76a208ed30cc1bd54262302b2aed27ae142509
Last commit before the change: 8c76a20
The SCSS has been completely refactored to better match upstream—this should not matter much to end-users or admins, but may greatly affect forks.
2024-01-24 - 634acd0 (#2580)
Branch with the 2024-02-14 security fixes: glitch-soc/security/915cd36ac11fc9d6fd221d68ed5b0749b88c7348
Last commit before the change: 915cd36
Logging format of the streaming server changed for a structured JSON format. This doesn't require changes unless you parse/monitor those logs.
The recommended Ruby version has changed from 3.2.2 to 3.2.3. If you are using
rbenv
, update the list of available versions and install Ruby 3.2.3 by doingRUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install
in the Mastodon install directory (e.g./home/mastodon/live
).2024-01-14 - 04f786a (#2568)
Branch with the 2024-02-14 security fixes: glitch-soc/security/5f8618443c694e24577f722968c118162c86212c
Last commit before the change: 5f86184
Fontawesome icons have been replaced by Material Symbols. This should not require any action from server admins, but this will likely disrupt downstreams and user styles.
2024-01-11 - cbc9516
Last commit before the change: e5b97ea
fr-QC has been changed to fr-CA, this shouldn't cause issues if the migrations run correctly, but this could affect forks if they have their own translations.
2023-12-29 - 6fe978f (#2544)
Branch with the 2024-02-14 security fixes: glitch-soc/security/19e14654ccde8fb8e8412d3f4575bbcff3184a33
Last commit before the change: 19e1465
The follow recommendation algorithm changed. For the Elasticsearch-based ones to work properly, accounts need to be re-indexed with
tootctl search deploy --only=accounts
2023-12-22 - e676b57 (#2537)
Branch with the 2024-02-14 security fixes: glitch-soc/security/f96e71352244b1fb43fe1cdf6ec7608f7486d29d
Last commit before the change: f96e713
Cookies and Rails cache format have changed. Zero-downtime rolling upgrades should be possible if you have already updated recently. Otherwise, stopping all services then starting them. See mastodon#27393 and mastodon#27392
2023-12-21 - d668b85 (#2532)
Branch with the 2024-02-14 security fixes: glitch-soc/security/f425a1e6378bd4fbed568100f0c26acfc6db8fd9
Last commit before the change: f425a1e
The Dockerfile has been rewritten and the streaming server is now in a dedicated docker image, see mastodon#26850
2023-12-19 - 4fdbffc (#2522)
Branch with the 2024-02-14 security fixes: glitch-soc/security/18856371be8603b7f720afaf8500b656c4667573
Last commit before the change: 3d3fa75
Last commit without known significant bugs before the change: 1885637 (bug is #2529
corepack
, otherwise you'll have to either install yarn 4 or enablecorepack
The text was updated successfully, but these errors were encountered: