Search

Mastodon may optionally utilize an installation of Elasticsearch or OpenSearch. Administrators may add either service to enable full-text search features.

Note

Other Elasticsearch API-compatible search providers may also work with Mastodon. These alternatives are not tracked as part of this matrix, so consult your chosen software’s own documentation for its Mastodon compatibility.

Elasticsearch

	Mastodon — click a version to focus its column
	4.6	4.5	4.4	4.3	4.2	4.1	4.0	3.5	3.4
9.x	✓	✓	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable
8.x	✓	✓	✓	✓	✓	✓	✓	✕	Not applicable
7.x	!	!	!	!	!	!	!	!	!
6.x	✕	✕	✕	✕	✕	✕	✕	✕	!

✓ Compatible ! Not Reccomended ✕ Incompatible – Not Supported

▸ Plan a Elasticsearch upgrade

Select your current Elasticsearch version to see upgrade guidance.

References: Elasticsearch Maintenance Policy

# Check running version
elasticsearch --version

OpenSearch

	Mastodon — click a version to focus its column
	4.6	4.5	4.4	4.3	4.2	4.1	4.0	3.5	3.4
3.x	✓	✓	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable	Not applicable
2.x	✓	✓	✓	✓	✓	✓	✓	Not applicable	Not applicable
1.x	!	!	!	!	!	!	!	!	!

✓ Compatible ! Not Reccomended ✕ Incompatible – Not Supported

▸ Plan a OpenSearch upgrade

Select your current OpenSearch version to see upgrade guidance.

References: OpenSearch Maintenance Policy

# Check running version
opensearch --version

OpenSearch is an open-source fork of Elasticsearch, created by AWS in 2021 after Elastic moved Elasticsearch off of its previous open-source (Apache 2.0) license. Forked from Elasticsearch 7.10.2 and now stewarded by the Linux Foundation, OpenSearch remains Apache 2.0-licensed. The two projects have diverged over time, but for Mastodon’s purposes they remain interchangeable, which is why their versions are tracked separately below but either may be used. New deployments are encouraged to use OpenSearch for its open-source license and active community development.