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.

Observação

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.
To verify MongoDB Server and MongoDB Search version pairings, see MongoDB Server and MongoDB 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.
To verify which Community Edition packages are supported on which Linux platforms, see MongoDB Search Package and Operating System Support.
To rule out architectures and operating systems that are not valid deployment targets, see Unsupported Platforms and Environments.
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.

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:

Componente	Minimum version
Servidor MongoDB	8.3.4
`mongot`	1.70.1
Controladores MongoDB para operador Kubernetes	1.9.1
Ops Manager or Cloud Manager	Latest (Enterprise deployments only)

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

Compatibilidade

`mongot` e a `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.

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.
For supported hardware architectures, see Supported Hardware Architectures.
For supported Ops Manager versions, see Cloud Manager and Ops Manager Versions.

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.

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 e posterior	✅	✅	❌

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 e posterior	✅	❌

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.

produto	Pacote	`mongot` Versão	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 e posterior	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅

Unsupported Platforms and Environments

The following platforms and environments are not supported:

Platform or environment	Notas
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	Plataforma	Pacote	Community Edition tarball or container	Community Edition MCK managed	Enterprise Advanced tarball or container	Enterprise Advanced Ops Manager managed	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	Plataforma	Pacote	`mongos`	Controladores MongoDB para operador Kubernetes	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.

Implantações fragmentadas

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.

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.

Saiba mais

Voltar

Visão geral

Introdução

Compatibility and Requirements for mongot