Components
Node
Mastodon requires an installation of Node for asset compilation, and administrators must ensure a supported Node version is present and configured for operation of the streaming API.
Versions of Mastodon are listed across the top of the matrix. Versions of each required component are listed along the left side.
| 4.6 | 4.5 | 4.4 | 4.3 | 4.2 | |
|---|---|---|---|---|---|
| 24.x | |||||
| 22.x | |||||
| 20.x | |||||
| 18.x | |||||
| 16.x | |||||
| 14.x |
| Key | |
|---|---|
| Supported in this version | |
| End of life, use with caution | |
| Not supported in this version |
References: Node.js Releases
Terminal
# Check running version
node -v
Mastodon will have a file called
.nvmrc in the source code that is the expected target version for that release.
You should use nvm to install and manage the target Node version.Odd numbered major Node.js releases (25.x, etc) should be used with caution and are recommended for use only by experienced administrators who are willing/able to provide feedback.
The official Mastodon container image will always use the correct target version of Node for that release.
Ruby
Mastodon requires an installation of Ruby for the webserver and Sidekiq components, and administrators must ensure a supported Ruby version is present and configured.
Postgres
Mastodon requires an installation of Postgres as the primary SQL database, and administrators must ensure a supported Postgres version is present and configured.