Skip to main content

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 1404
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 71
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 6
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 versionsRHEL mappingMongodb versions
>=349.0 | 9.3>=6.0.4 <=8.0.9
>=288.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 5
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 3 (or 0.3)
Highest version is 7
Default version is 7

Linux Mint​

Supported

(uses mongodb's ubuntu release)
Lowest supported Distribution version is 17
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