mongodb-memory-server/docs/guides/supported-systems.md

id, title

id	title
supported-systems	Supported Systems

Currently Supported platforms:

• win32 / windows
• macos / osx / darwin
• linux

Officially Supported Architectures:

• x64 / x86_64
• arm64 / aarch64 (only some linux distros have binaries)

:::note On systems that have native arch translation (like ARM MacOS), the architecture will need to be overwritten with MONGOMS_ARCH=x64. :::

---

Legend:

• Supported means that it is supported by mongodb natively or is a distro that is based on a supported distro.
• Untested means that it is not tested on hardware and so not verified to work.
• Outdated means that the current mappings for MMS are outdated and may not have proper tests.
• Unsupported means that it is unsupported by MMS and mongodb.
• Working means that it is supported by MMS but not by mongodb natively and not based on a supported distro.

Windows

Supported

Should just work out of the box

MacOS

Supported

On x64 systems, it should work right out of the box
Since Mongodb 6.0.0, they have arm64 binaries
Uses arm64 binaries for all versions above or equal to 6.0.0, for older versions falls back to using x86_64 binaries (requires Rosetta)
Usage of the x86_64 binary can be forced with MONGOMS_ARCH=x64 (or equal in package.json)

Linux

Depends on the distribution, many common ones should just work right out of the box

Ubuntu (and based on systems)

Supported

(uses mongodb's ubuntu release)
Lowest supported Distribution version is 1604
Highest version is 2404 (higher versions will be clamped to this value)
Default version is 2204
Architectures Supported: x86_64, arm64(aarch64)

:::note Lower Versions than 2004 may be used if mongodb dosnt provide binaries for an lower version of mongodb for an higher version of ubuntu ::: :::note Since Mongodb 6.0.4 there are binaries for 2204, any version before is mapped to 2004 (or earlier) and will require libssl1.1 to be installed.
See this mongodb issue. :::

Debian

Supported

(uses mongodb's debian release)
Lowest supported Distribution version is 9.2
Highest version is 12 (higher versions will be clamped to this value)
Default version is 12 (when in unstable or testing, otherwise none)

Fedora

Supported

(uses mongodb's rhel release)
Lowest supported Distribution version is 12
Highest version is 42 (see note) (higher versions will be clamped to this value)
Default version is 28 (when above or equal to 28, otherwise none)

Mongodb compat chart (x86_64) (Limited to currently known mongodb versions as of writing)

Fedora versions	RHEL mapping	Mongodb versions
>=34	9.0 | 9.3	>=6.0.4 <=8.0.9
>=28	8.0	>=3.4.24 <=8.0.9

:::note There are no official builds from mongodb for fedora.
This mapping to RHEL is based on the table in Relationship between Fedora and RHEL. :::

Rhel

Untested

(uses mongodb's rhel release)
Lowest supported Distribution version is 6.2
Highest version is 9.3 (higher versions will be clamped to this value)
Default version is 70
Architectures Supported: x86_64, arm64(aarch64)

:::note arm64/aarch64 support is only for Rhel 8.2 & mongodb 4.4.2 or Rhel 9 & mongodb 6.0.7 :::

Amazon

Supported

(uses mongodb's amazon release)
Lowest supported Distribution version is 1
Highest version is 2
Default version is 1

ElementaryOS

Untested Outdated

(uses mongodb's ubuntu release)
Lowest supported Distribution version is 4
Highest version is 7
Default version is 7

Linux Mint

Supported

(uses mongodb's ubuntu release)
Lowest supported Distribution version is 18
Highest version is 22
Default version is 21

Suse

Untested Outdated

(uses mongodb's suse release)
Lowest supported Distribution version is 11
Highest version is 15
Default version is 15

:::note Currently the only test is opensuse-tumbleweed. More OS testing data would be appreciated (follow Issue Template Distribution Support). ::: :::note Suse 15 binaries still require OpenSSL 1.1 installed. This may conflict with latest versions of opensuse-tumbleweed. A workaround reported to work is to use the rhel-9 binaries via config option DISTRO. Original Comment on #948. :::

Arch

Unsupported Working

There are no official mongodb builds for Arch Distributions, but the ubuntu binaries work on most Arch systems, so they are used.
Currently Mapping to: ubuntu2204

:::note Because Arch* dosnt base on ubuntu, there is no specific ubuntu version associated with an arch version, so it defaults to highest supported ubuntu version ::: :::note MongoDB Binary versions before 6.0.4 require OpenSSL 1.1 installed, on arch can be installed via core/openssl-1.1. :::

Gentoo

Unsupported Working

There are no official mongodb builds for Gentoo Distributions, but the debian binaries work on most Gentoo systems, so they are used.
Currently Mapping to: debain11

:::note Because Gentoo dosnt base on debian, there is no specific debian version associated with an gentoo version, so it defaults to highest supported debian version :::

Alpine

Unsupported

There are no official mongodb builds alpine, though there are some unoffical build of mongodb build for it which can be used

NixOS

Unsupported

There are no official mongodb builds for NixOS, however some users report the ubuntu binaries work with some extra configuration on NixOS, see Issue #782