Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Gradle Mongo Plugin

Maven Central Build Status

The Gradle Mongo Plugin allows you to run a managed instance of Mongo from your gradle build.

It's available on both Maven Central and the Gradle Plugin Portal.


Enable the plugin in your gradle build:

plugins {
  id 'com.sourcemuse.mongo' version '2.0.0'

Hey presto, you can now declare a dependency on a running mongo instance from any of your tasks:

task integrationTest(type: Test) {
    runWithMongoDb = true


Configure your Mongo instances inside a mongo block:

mongo {
    port 12345
    logging 'console'

The mongo configuration block can be declared at either the project or the task level. Task-level configuration inherits from any project-level configuration provided.

The following properties are configurable:

  • args: A <String,String> map of mongod command-line options (value can be empty for arguments without values) (defaults to [:])
  • artifactStorePath The location where Mongo will be downloaded to
  • auth: Enables access control (defaults to false)
  • bindIp: The ip address Mongo binds itself to (defaults to '')
  • downloadUrl: The URL from where Mongo will be downloaded
  • journalingEnabled: Toggles journaling (defaults to false)
  • logFilePath: The desired log file path (defaults to 'embedded-mongo.log')
  • logging: The type of logging to be produced: 'console', 'file' or 'none' (defaults to 'file')
  • mongodVerbosity: The verbosity level of the mongod process. Supported options are as per the mongod configuration documentation (default level is non-verbose)
  • mongoVersion: The version of Mongo to run. Can be 'DEVELOPMENT' or 'PRODUCTION' for the latest versions of the respective branch, or take the form '1.2-LATEST' or '1.2.3' for specific versions
  • params: A <String,String> map of MongoDB Server Parameters (defaults to [:])
  • port: The port Mongo will listen on (defaults to 27017). For random port assignment, set this value to 'RANDOM' (the actual port value used will be available during the build through the project.mongo.port property)
  • proxyHost: The proxy host name for Mongo downloads
  • proxyPort: The proxy port for Mongo downloads
  • storageEngine: The name of the storage engine to use. Can be 'wiredTiger' or 'mmapv1' for MongoDB Community Edition (default is 'wiredTiger' for Mongo 3.2 and later; otherwise it is 'mmapv1'). Alternative distributions might support additional engines
  • storageLocation: The directory location from where embedded Mongo will run, such as /tmp/storage (defaults to a java temp directory)
  • syncDelay: The interval in seconds between fsync operations where mongod flushes its working memory to disk. See syncdelay parameter for more information


For your convenience the plugin also adds the following tasks to your buildscript:

$ gradle tasks
Mongo tasks
startManagedMongoDb - Starts a local MongoDb instance which will stop when the build process completes
startMongoDb - Starts a local MongoDb instance
stopMongoDb - Stops the local MongoDb instance


Gradle plugin for running a managed instance of Mongo.








No packages published