Components

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.

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

libvips

	4.6	4.5	4.4	4.3	4.2
8.17
8.16
8.15
8.14
8.13

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

References: libvips

Terminal

# Check running version
vips --version

The official Mastodon container image since version 4.4 will always use the highest possible libvips version for that release.

ImageMagick

	4.6	4.5	4.4	4.3	4.2
7.0+
6.9.7-7+

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

References: ImageMagick

Terminal

# Check running version for 7.x
magick --version
# Check running version for 6.x
convert --version

All Mastodon installs still using ImageMagick should run at least 6.9.7-7 to mitigate CVE-2023-36460, see this guide for more details.

Edit this pageorReport an issue

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.

FFmpeg

Mastodon requires an installation of FFmpeg for video processing, and administrators must ensure a supported FFmpeg version is present and configured.