Components

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.

Versions of Mastodon are listed across the top of the matrix. Versions of each required component are listed along the left side.

Valkey

	4.6	4.5	4.4	4.3	4.2
9.0
8.1
8.0

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

References: Valkey Releases

Terminal

# Check running version
valkey-server --version

Redis

	4.6	4.5	4.4	4.3	4.2
8.2
8.0
7.4
7.2
7.0
6.2
6.0

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

References: Redis Releases

Terminal

# Check running version
redis-server --version

Mastodon has not required upgrades of Redis for many years, but this has changed with versions 4.4+. Please review the available versions in your deployment carefully before upgrading.

Dragonfly

	4.6	4.5	4.4	4.3	4.2
1.27+
1.26.3+

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

References: Dragonfly Releases

Terminal

# Check running version
dragonfly --version

Dragonfly as a Redis API-compatible platform should be used with caution and is recommended for use only by experienced administrators who are willing/able to provide feedback.

Edit this pageorReport an issue

Postgres

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

libvips

Mastodon requires an image processor, preferably libvips. Support for ImageMagick may be removed in a future release and administrators should plan to migrate now.