hmrc / play-reactivemongo

ReactiveMongo plugin for Playframework

Version Matrix

ReactiveMongo Support to Play! Framework

Build Status Download

A plugin for Play 2.x, enabling support for ReactiveMongo - reactive, asynchronous and non-blocking Scala driver for MongoDB.

This provides the configuration and mongo connectivity to functionality in simple-reactivemongo

Main features

Configure your application to use ReactiveMongo plugin

add to your conf/application.conf

play.modules.enabled += "play.modules.reactivemongo.ReactiveMongoHmrcModule"

Configure your database access within application.conf

This plugin reads connection properties from the application.conf and gives you an easy access to the connected database.

Add this to your conf/application.conf

The plugin will look for the mongo config under:

  • the config root, then if not found
  • the root of the Application#mode, then if not found
  • the root of the Application#Dev

mongodb {
    uri = "mongodb://username:password@localhost:27017/your_db_name"
    channels = 5
    failoverStrategy = {
        initialDelayMsecs = 100
        retries = 10
        delay = {
            function = fibonacci
            factor = 1


Include the following dependency in your SBT build

resolvers += Resolver.bintrayRepo("hmrc", "releases")

libraryDependencies += "" %% "play-reactivemongo" % "[INSERT_VERSION]"

For Java 7 and Play 2.3.x use versions <=4.3.0

Upgrading from 5.x.x to 6.x.x?

Due to the upgrade of the underlying reactivmongo, there are several documented breaking changes. Details and fixes for these are documented in the upgrade details for (simple-reactivmongo)[].


This code is open source software licensed under the Apache 2.0 License.