Make Peace, No War!

Organization Flapdoodle OSS

We are a github organization. You are invited to participate. Every version < 4.x.x is considered as legacy.

Upcoming changes

We are moving to Codeberg.

Embedded MongoDB

Embedded MongoDB will provide a platform neutral way for running mongodb in unittests.

Why?

• dropping databases causing some pains (often you have to wait long time after each test)
• its easy, much easier as installing right version by hand
• you can change version per test

How?

• download mongodb (and cache it)
• extract it (and cache it)
• java uses its process api to start and monitor the mongo process
• you run your tests
• java kills the mongo process

License

We use http://www.apache.org/licenses/LICENSE-2.0

Dependencies

Build on top of

• Embed Process Util de.flapdoodle.embed.process

Other ways to use Embedded MongoDB

• in a Maven build using maven-mongodb-plugin or embedmongo-maven-plugin
• in a Clojure/Leiningen project using lein-embongo
• in a Gradle build using gradle-mongo-plugin
• in a Scala/specs2 specification using specs2-embedmongo
• in Scala tests using scalatest-embedmongo

Howto

• Use Cases
• Basics
• Customizations

Maven

<dependency>
	<groupId>de.flapdoodle.embed</groupId>
	<artifactId>de.flapdoodle.embed.mongo</artifactId>
	<version>5.0.0</version>
</dependency>

To enable logging you must choose some matching adapter for slf4j.org This projects uses slf4j-api version 1.7.xx.

Changelog

Unreleased

5.0.0

• upgrade to flapdoodle commons
• dep updates

4.33.0

• mongodb 8.3 and 8.2, ubuntu 26.04 detection

4.24.0

• dep updates, force clean temp on teardown

4.23.0

• dep updates, latest mongod versions to fix CVE-2025-14847

4.22.0

• dep updates, latest mongod versions (8.2.2, 8.0.16, 7.0.26, ...)

4.21.0

• dep updates, latest mongod versions

4.20.1

• dep updates

4.20.0

• customizable mongo client settings

4.19.0

• dep updates, mongodb up to 8.0.5

4.18.1

• dep updates, mongodb up to 8.0.3

4.17.0

• dep updates, enhanced proxy support

4.16.2

• download move atomic exception fix

4.16.1

• download cache race condition fix

4.16.0

• download cache error messages
• os detection fix (amazon detection)

4.15.0

• mongo shell binary removal fix
• alpine linux detection
• mongodb 7.0.12 support
• os detection fix (use best version if two matches)

4.14.0

• mongodb 7.0.11 support
• rocky linux support

4.13.1

• mongod server start timeout increased from 20s to 30s
• mongod server start timeout is now configurable

4.13.0

• mongodb 7.0.9, 8.0.0-rc3
• detect ubuntu 24.04
• bugfix in embed.process

4.12.6

• mongodb 7.0.8

4.12.5

• bugfix in embed.process

4.12.3

• alma linux support
• dependency updates
• mongodb version support for 7.0.7, 7.3.0, etc

4.12.2

• bugfix in embed.process

4.12.1

• dependency updates
• bugfix in embed.process

4.12.0

• dependency updates
• mongodb 7.0.4 version added

4.11.1

• update mongo driver version
• setup user and roles
• init replica set client code backport

4.10.2

• package resolver dep upgrade

4.10.1

• debian 12/13 package resolver bugfix

4.10.0

• customize package resolving
• use user info in download base url as basic auth information (see)

4.9.3

• all the good stuff

Spring Integration

As the spring projects removed the embed mongo support in 2.7.0 you should consider to use one of these integration projects. It should behave mostly like the original spring integration, but there are some minor differences:

• version in 'spring.mongodb.embedded.version' is used in package resolver and is not matched against version enum.
• 'spring.mongodb.embedded.features' is not supported (not the way to change the config of mongodb)

If you have any trouble in using them feel free to create an issue.

• Spring 2.5.x
• Spring 2.6.x
• Spring 2.7.x
• Spring 3.x.x