Components

Postgres

Mastodon requires an installation of Postgres as the primary SQL database, and administrators must ensure a supported Postgres version is present and configured.

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
18.x
17.x
16.x
15.x
14.x
13.x
12.x
11.x
10.x

Key
	Supported in this version
	End of life, use with caution
	Not supported in this version

References: Postgres Versioning

Terminal

# Check running version
psql --version

Always use caution when moving between major versions of Postgres (ex: 15.x to 16.x) as failure to adequately plan this migration may result in data-loss!

Edit this pageorReport an issue

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.

Cache

Mastodon requires administrators to choose a Redis-compatible backend for operation. It supports Redis, Valkey, or DragonflyDB, and one of these must be is present and configured.