Warning

This package is deprecated and no longer maintained. It supports Umbraco 13 / .NET 8 at most and will not get further updates.

Use UmbracoExternalStorageWithMongoDB (Umbraco 17+), which is built on MongoDbService. Its README has an upgrade guide.

Not carried over to the replacement:

• X.509 client-certificate authentication (CertificateFilePathWithName / CertificatePassword)
• Automatic per-environment, per-machine database-name prefixes outside Production
• Choosing a database by name at runtime via MongoDBClientConnection.GetDatabase("...") (the replacement uses a single database from MongoDbSettings:DatabaseName)

Setup procedure

The appsettings.json file should be given a connection string to your MongoDB databases

{
	"MongoDbCredentials": {
	    "CertificateFilePathWithName": "<optional Certificate file path with name [pfx file]>",
	    "CertificatePassword": "<optional Certificate password>",
	    "ConnectionString": "<mandatory> mongodb+srv://cluster0.fyu.mongodb.net/?authSource=%24external&authMechanism=MONGODB-X509&retryWrites=true&w=majority"
	  }
}

Sample code

var database = MongoDBClientConnection.GetDatabase("YouDatabaseName");
var collection = database.GetCollection<T>("YourCollectionName"); // of type T

For more examples on how to Insert, Modify your data, check the MongoDB official documentation: https://www.mongodb.com/docs/drivers/csharp/current/quick-reference/