Releases: Mongo2Go/Mongo2Go
Release list
v5.0.0 — MongoDB 8.0.26
Mongo2Go 5.0.0 bundles MongoDB 8.0.26 (the 8.0 LTS line) and Database Tools 100.14.0, replacing 4.4.4 / 100.3.1. Because MongoDB 8.0 raises the minimum operating system, this is a major, breaking release.
⚠️ Breaking — minimum OS requirements
MongoDB 8.0 needs newer platforms than 4.4 did. Before upgrading, check that your runtime meets:
- Linux — glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+, RHEL 9+, Amazon Linux 2023+). The bundled Linux binaries are the
ubuntu2204build and link OpenSSL 3. - macOS — Apple Silicon (arm64) and Intel (x64).
- Windows — x64.
If you must run on older Linux (glibc < 2.35), stay on the 4.x line.
✨ Highlights
- Native macOS arm64 (Apple Silicon) — a native
mongod/mongoimport/mongoexportis now bundled, so there is no more Rosetta 2. Together with the Linux arm64 support from 4.2.0 this completes #127. Bundled platforms are now Windows x64, Linux x64 & arm64, and macOS x64 & arm64. libcrypto.so.1.1/libssl.so.1.1no longer required — 8.x links OpenSSL 3, which ships on every currently supported distribution and inmcr.microsoft.com/dotnet/sdk:8.0. The oldlibssl1.1workaround is gone. Fixes #149 and (very likely) #135.- "Too many open files" fixed (#147) — process handles for
chmod,mongoimport/mongoexport, and the replica-set initialisation client were leaking file descriptors on every runner start and every import/export. They are now disposed deterministically, so large test suites no longer exhaust the OS open-file limit. - Strong-named assembly (#150) —
Mongo2Go.dllis now strong-named, so it can be referenced from strong-named / signed consumer projects.
🔧 Under the hood
MongoDownloadercan now pin an exact MongoDB server and tools version, so a release is reproducible.
📦 Install
dotnet add package Mongo2Go --version 5.0.0
Thanks to everyone who reported the issues fixed here: #132, #127, #149, #147 and #150.
v4.2.0
Highlights
- Linux ARM64 support — native
mongod/mongoimport/mongoexportare now bundled and
selected automatically per architecture (#127). Apple Silicon keeps using the x64 macOS
binaries under Rosetta 2, since MongoDB 4.4 has no macOS arm64 build. - Security: vulnerable dependencies resolved — MongoDB.Driver 3.1.0 → 3.9.0 clears the
SharpCompress and Snappier advisories (#160, PR #159 — thanks @schms27). - Smaller package — the bundled binaries are now stripped (~22% smaller). Even with the
added arm64 binaries, the package is smaller than 4.1.0.
Under the hood
- Downloaded MongoDB archives are verified against MongoDB's published SHA-256, and the bundled
binaries are checksum-verified at runtime — a stronger supply-chain guarantee. - Releases now use Trusted Publishing (OIDC) with a manual-approval gate; no stored API key.
The bundled MongoDB version remains v4.4.4.
Full changelog: v4.1.0...v4.2.0
v4.1.0
Mongo2Go 4.1.0, January 30 2025
- Updated MongoDB.Driver to version 3.1.0, ensuring compatibility with the latest MongoDB client features (PR #156, fixes #154 - many thanks to Teneko)
- Please note that the bundled version of MongoDB included with this package remains v4.4.4.
- Note for Ubuntu users: MongoDB 4.4.4 requires libcrypto.so.1.1, which is no longer included in Ubuntu 22.04 and newer. If you encounter an error like:
You can fix this by installing OpenSSL 1.1 manually:
error while loading shared libraries: libcrypto.so.1.1: cannot open shared object file: No such file or directoryThis restoresecho "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list sudo apt update sudo apt install -y libssl1.1
libcrypto.so.1.1and allows Mongo2Go/MongoDB to run properly.
v4.0.0
Mongo2Go 4.0.0, November 19 2024
- A big thank you to DrewM-Hax0r for championing this release! (PR #153, fixes #152)
- This is a new major version for Mongo2Go (4.x), driven by:
- Dropping support for old .NET Framework versions earlier than 4.7.2 due to updated framework targets.
- MongoDB driver switching to strong-named assemblies (see .NET Driver Version 2.28.0 Release Notes).
- Updated MongoDB driver to version 3 and re-targeted the project to meet the requirements of the new driver version.
- Fixed an issue with the single-node replica set option, caused by outdated connection strings that were incompatible with the latest MongoDB driver.
- Replaced deprecated dependent packages with updated, supported versions, and patched vulnerabilities by upgrading vulnerable dependencies.
- Please note that the bundled version of MongoDB included with this package has not changed and is still v4.4.4. This version of MongoDB is still compatible with the latest version of the driver, so there was no need to update at this time.
- Bugfix: Corrected binary search path on Linux when
NUGET_PACKAGESis specified (PR #140, fixes #134 - many thanks to Ove Andersen) - Bugfix: Stops extra empty temporary data being generated (PR #138, fixes #136 - many thanks to Alex Wardle)
v3.1.3
Mongo2Go 3.1.3, April 30 2021
- targeting .NET Standard 2.0 instead of 2.1, this makes Mongo2Go compatible with .NET Framework (version 4.7.1 and later) (PR #118 - many thanks to Cédric Luthi)
- fixes handling of the path search for the NUGET_PACKAGE environment variable (PR #119 - many thanks to Timm Hoffmeister)
- internal:
dotnet packis now used to create the nupkg file for a release (PR #121 - many thanks to Cédric Luthi)
v3.1.2 (broken)
Mongo2Go 3.1.2, April 28 2021
- targeting .NET Standard 2.0 instead of 2.1, this makes Mongo2Go compatible with .NET Framework (version 4.7.1 and later) (PR #118 - many thanks to Cédric Luthi)
- fixes handling of the path search for the NUGET_PACKAGE environment variable (PR #119 - many thanks to Timm Hoffmeister)
v3.1.1
Mongo2Go 3.1.1, April 08 2021
- internal: Better algorithm for determining a free port. This allows parallel execution of tests and increases compatibility with Raider and other test runners. (PR #116, fixes #115 and #106 - many thanks to liangshiwei)
v3.1.0
Mongo2Go 3.1.0, April 07 2021
- NEW: Configurable logging! adds the option to inject a
Microsoft.Extensions.Logging.ILoggertoMongoDbRunner.Start(logger)arguments. Now you can adjust or disable the console output to avoid noise in CI environments. Please note the two examples shown above. (PR #113, fixes #94, #95 and #113 - many thanks to Corentin Altepe) - internal: replaces
--sslMode disabled(deprecated) with--tlsMode disabledin command line arguments to mongod.
v3.0.0
Mongo2Go 3.0.0, March 26 2021
-
includes MongoDB binaries of version 4.4.4 with support for Windows, Linux and macOS
-
targets .NET Standard 2.1 (can be used with .NET Core 3.0 and .NET 5.0)
-
adds new MongoDownloader tool (PR #109, fixes #82 and #112 - many thanks to Cédric Luthi)
-
adds support for
NUGET_PACKAGESenvironment variable (PR #110 - many thanks to Bastian Eicher)
v2.2.16
Mongo2Go 2.2.16, December 13 2020
- fix for non existing starting path for binary search (PR #107, fixes #105 - many thanks to Gurov Yury)