Compatibility and Requirements for mongot

For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

Compatibility and Requirements for mongot

This page describes version compatibility, minimum component requirements, operating system support, and deployment compatibilities for self-managed MongoDB Search and MongoDB Vector Search.

Note:

Unless otherwise noted, Community Edition statements apply to mongot 1.70.1 and later.

How to Use This Page

Use the following sections to verify your deployment target and configuration:

  • To verify minimum versions and component requirements for MongoDB Controllers for Kubernetes Operator-managed deployments, see [Search and Vector Search Compatibility and Requirements.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-search-vector-search-compatibility-requirements

  • To verify MongoDB Server and MongoDB Search version pairings, see [MongoDB Server and MongoDB Search Version Compatibility.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-server-search-version-compatibility

  • To verify MongoDB Search and MongoDB Controllers for Kubernetes Operator version pairings, see [MongoDB Search and MongoDB Controllers for Kubernetes Operator Version Compatibility.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-search-mck-version-compatibility

  • To verify which Community Edition packages are supported on which Linux platforms, see [MongoDB Search Package and Operating System Support.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-search-package-os-support

  • To rule out architectures and operating systems that are not valid deployment targets, see [Unsupported Platforms and Environments.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-unsupported-platforms-envs

  • To determine whether a MongoDB Search deployment can be combined with MongoDB Server, MongoDB Controllers for Kubernetes Operator, Ops Manager, and related components for your intended topology, see [Compatibility Tables.](https://www.mongodb.com/docs/search/self-managed/current/deployment/compatibility-requirements.md#std-label-compatibility-tables

Search and Vector Search Compatibility and Requirements

This section describes the version compatibility and minimum component requirements for running MongoDB Search and MongoDB Vector Search with the MongoDB Controllers for Kubernetes Operator.

Minimum Required Versions

To deploy MongoDB Search and MongoDB Vector Search with the MongoDB Controllers for Kubernetes Operator, run the following component versions or later:

Component Minimum version
MongoDB Server 8.3.4
mongot 1.70.1
MongoDB Controllers for Kubernetes Operator 1.9.1
Ops Manager or Cloud Manager 8.0.25

You can run newer versions of any component if the combinations remain within the supported pairings described in the following sections.

Compatibility

mongot and mongod

For MongoDB Controllers for Kubernetes Operator-managed deployments, any supported mongot version is compatible with any supported mongod version of MongoDB Server 8.3.4 or later.

The following compatibility behaviors apply:

  • mongot 1.70.1 works with mongod 8.3.x.

  • Features added in newer mongot might require a newer mongod to function.

  • Existing features remain consistent when you upgrade``mongot`` without upgrading mongod or when you upgrade mongod without upgrading mongot.

mongot and the Kubernetes Operator

The Kubernetes Operator declares the mongot versions it supports. Use the Kubernetes Operator version that ships alongside or after the mongot version you deploy. The compatibility table later on this page starts with mongot 1.70.1 and MongoDB Controllers for Kubernetes Operator 1.9.1, which are the minimum documented versions for MongoDB Controllers for Kubernetes Operator-managed MongoDB Search and MongoDB Vector Search deployments. To learn more, see [MongoDB Controllers for Kubernetes Operator Compatibility.](https://www.mongodb.com/docs/kubernetes/upcoming/tutorial/plan-k8s-op-compatibility#std-label-k8s-compatibility

Supported Platforms and Editions

MongoDB Search and MongoDB Vector Search on Kubernetes inherit the platform support of the MongoDB Controllers for Kubernetes Operator. Confirm your cluster meets the MongoDB Controllers for Kubernetes Operator requirements before you deploy mongot.

  • For supported MongoDB Server versions and base images, see [Supported Platforms and MongoDB Versions.](https://www.mongodb.com/docs/kubernetes/upcoming/tutorial/plan-k8s-op-compatibility#std-label-k8s-mdb-version-compatibility

  • For supported hardware architectures, see [Supported Hardware Architectures.](https://www.mongodb.com/docs/kubernetes/upcoming/tutorial/plan-k8s-op-compatibility#std-label-k8s-supported-hardware-arch-compatibility

  • For supported Ops Manager versions, see [Cloud Manager and Ops Manager Versions.](https://www.mongodb.com/docs/kubernetes/upcoming/tutorial/plan-k8s-op-compatibility#std-label-k8s-onprem-version-compatibility

You can run MongoDB Search and MongoDB Vector Search against either edition of MongoDB Server that the Kubernetes Operator manages:

  • Community Edition: Manage the source mongod through the MongoDBCommunity resource. Ops Manager and Cloud Manager do not apply in this configuration.

  • Enterprise Advanced: Manage the source mongod through the MongoDB resource, paired with Ops Manager or Cloud Manager.

Both editions use the same MongoDBSearch resource to deploy mongot. For a deployment external to the Kubernetes Operator, reference it through spec.source.external on the MongoDBSearch resource. To learn more, see [MongoDB Search and Vector Search Settings.](https://www.mongodb.com/docs/kubernetes/upcoming/reference/fts-vs-settings#std-label-k8s-fts-vs-settings

Product and Operating System Support

The following tables show version pairings and Linux package support so you can verify:

  • which MongoDB Server versions pair with a given MongoDB Search version

  • which MongoDB Controllers for Kubernetes Operator versions pair with a given MongoDB Search version

  • which Community Edition packages are supported on which Linux platforms

MongoDB Server and MongoDB Search Version Compatibility

The following table shows which MongoDB Server major versions are compatible with MongoDB Search versions.

MongoDB Search version MongoDB Server 8.3 MongoDB Server 8.2 MongoDB Server 8.0
1.70.1 and later ✅ ❌ ❌

MongoDB Server 8.2 has reached end of life and is no longer a supported source deployment for MongoDB Search. Upgrade to MongoDB Server 8.3 or later. To learn more, see the MongoDB Software Lifecycle Schedules.

MongoDB Search and MongoDB Controllers for Kubernetes Operator Version Compatibility

The following table shows which MongoDB Controllers for Kubernetes Operator versions are compatible with MongoDB Search versions for MongoDB Controllers for Kubernetes Operator-managed deployments.

MongoDB Search version Kubernetes Operator 1.9.1 and later Kubernetes Operator earlier than 1.9.1
1.70.1 and later ✅ ❌

MongoDB Search Package and Operating System Support

For Community Edition, the following table shows which package types that Linux platforms support.

For MongoDB Controllers for Kubernetes Operator-managed Enterprise deployments, platform support inherits the Kubernetes Operator support matrix rather than the standalone Community Linux-host matrix.

Product Package mongot version Amazon Linux 2023 ARM64 Amazon Linux 2023 x86_64 Debian 12 x86_64 RHEL / Rocky / Alma / Oracle Linux 8.8 and later ARM64 RHEL / Rocky / Alma / Oracle Linux 8.8 and later x86_64 RHEL / Rocky / Alma / Oracle Linux 9.3 and later ARM64 RHEL / Rocky / Alma / Oracle Linux 9.3 and later x86_64 SUSE 15 x86_64 Ubuntu 20.04 ARM64 Ubuntu 20.04 x86_64 Ubuntu 22.04 ARM64 Ubuntu 22.04 x86_64 Ubuntu 24.04 ARM64 Ubuntu 24.04 x86_64
MongoDB Search Community Edition Linux tarball 1.70.1 and later ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

Unsupported Platforms and Environments

The following platforms and environments are not supported:

Platform or environment Notes
IBM Power (ppc64le) mongot is built for x86_64 and aarch64 Linux only.
IBM Z (s390x) mongot is built for x86_64 and aarch64 Linux only.
Native Windows deployment target Native Windows mongot binaries are not available.
Native macOS deployment target Native macOS mongot binaries are not available.
Windows Subsystem for Linux Support assumes a native Linux deployment target.
atlas-local Docker image in production atlas-local is a single-container development image, not a production deployment target.

For local development on macOS or Windows, use a Docker-based Linux runtime such as atlas-local on Docker Desktop rather than native mongot binaries.

Compatibility Tables

The first matrix identifies whether you can pair a MongoDB Search deployment type with a given MongoDB Server deployment type.

The second matrix identifies whether a given MongoDB Search deployment type works with related management components.

MongoDB Server and MongoDB Search Deployment Compatibility

MongoDB Search Platform Package Server Community Edition tarball or container Server Community Edition MCK managed Server Enterprise Advanced tarball or container Server Enterprise Advanced Ops Manager managed Server Enterprise Advanced MCK managed
MongoDB Search Community Edition Tarball ✅ ❌ ❌ ❌ ❌
Community Edition Container image ✅ ❌ ❌ ❌ ❌
Community Edition MCK managed ❌ ✅ ❌ ❌ ❌
Enterprise Advanced Tarbell or container ❌ ❌ ❌ ❌ ❌
Enterprise Advanced MCK managed ❌ ❌ ✅ ✅ ✅

Management and Runtime Compatibility

MongoDB Search Platform Package mongos MongoDB Controllers for Kubernetes Operator Ops Manager manages MongoDB deployment Ops Manager manages MongoDB Search Ops Manager observes MongoDB Search
MongoDB Search Community Edition Tarball ✅ ❌ ❌ ❌ ❌
Community Edition Container image ✅ ❌ ❌ ❌ ❌
Community Edition MCK managed ✅ ✅ ❌ ❌ ❌
Enterprise Advanced Tarbell or container ✅ ❌ ✅ ❌ ❌
Enterprise Advanced MCK managed ✅ ✅ ✅ ❌ ✅

Compatibility Notes

Load Balancing for Multi-mongot Topologies

If a replica set or shard uses more than one mongot instance, use an L7 load balancer. An L4 load balancer is not sufficient because mongod opens a long-lived connection to mongot and an L4 balancer cannot distribute traffic at the gRPC stream level.

Sharded Deployments

For sharded deployments, each shard has its own mongot group. Shards do not share mongot instances. In Kubernetes-based deployments, MongoDB Controllers for Kubernetes Operator can automate this topology. If you manually set up deployments, you must create and manage the per-shard topology.

Enterprise Production

For Enterprise Advanced, the intended production posture is MongoDB managed on VMs, bare metal, or Kubernetes, with MongoDB Controllers for Kubernetes Operator managing the mongot.

Ops Manager

Ops Manager can manage the MongoDB deployment that MongoDB Search uses and can surface curated MongoDB Search visibility, but it is not the management plane for MongoDB Search itself. To receive mongot metrics through Ops Manager monitoring, run Ops Manager 8.0.25 or later.

Docker

The following list details considerations for Docker deployments:

  • atlas-local is for local development and continuous integration only. It does not pair with an external MongoDB deployment.

  • Linux containerized MongoDB Search Community Edition is a supported packaging and runtime mechanism on supported Linux platforms.

  • Enterprise production support assumes MongoDB Controllers for Kubernetes Operator-managed MongoDB Search for Enterprise Advanced rather than standalone container lifecycle management.

Packaging

Tarball and container installs are the packaging paths for MongoDB Search Community Edition. Native package-manager installation with DEB or RPM is not yet available.

Learn More

  • [Known Limitations](https://www.mongodb.com/docs/search/self-managed/current/limitations.md#std-label-mongot-limitations

  • MongoDB Search and Vector Search Deployment with MCK

  • [Install and Use Search with MongoDB Community Edition](https://www.mongodb.com/docs/kubernetes/current/tutorial/install-fts-vs-with-community#std-label-k8s-fts-vs-install

  • [Install and Use Search with MongoDB Enterprise Edition](https://www.mongodb.com/docs/kubernetes/current/tutorial/install-fts-vs-with-enterprise#std-label-k8s-fts-vs-single-cluster-install

  • [Install and Use MongoDB Search and Vector Search with External MongoDB Enterprise Edition](https://www.mongodb.com/docs/kubernetes/current/tutorial/install-fts-vs-with-external-enterprise#std-label-k8s-fts-vs-install-external-enterprise

  • [MongoDB Search and Vector Search Settings](https://www.mongodb.com/docs/kubernetes/upcoming/reference/fts-vs-settings#std-label-k8s-fts-vs-settings