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.

Edit this pageorReport an issue

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.