• Getting Started

Getting Started

This quick-start privides just enough information to get you started using the .NET driver. Refer to the reference guide for more complete information.

System Requirements

.NET 4.5 or later is required to utilize the libraries. It has also been tested with Mono 3.10 on OS X.

Core CLR

As the Core CLR hasn’t shipped yet, we don’t yet have support for it. We run compatibility reports using the .NET Portability Analyzer to mitigate the need to make public API changes when we are ready to release compatible assemblies.

Nuget Installation

Nuget is the simplest way to get the driver. There are 4 packages available on nuget.

  • MongoDB.Driver: The new driver. It is mostly free of any legacy code and should be used for all new projects. More documentation can be found in the reference guide.
  • MongoDB.Driver.Core: The core of the driver and a dependency of MongoDB.Driver. You will probably not use this package directly. More documentation can be found in the reference guide.
  • MongoDB.Bson: The BSON layer. It is a dependency of MongoDB.Driver.Core. It may be used by itself. More documentation can be found in the reference guide.
  • mongocsharpdriver: The compatibility layer for those upgrading from our 1.x series. This should not be used for new projects. More information can be found in the 1.x documentation;

Binary Installation

Alternatively, if you’d like to pull down binaries, you can do that from the releases section on our github repository, which contains zip files for each release.

The assembly names mostly correlate strongly with the package names above. For new applications, you’ll add references to MongoDB.Driver.dll, MongoDB.Driver.Core.dll, and MongoDB.Bson.dll. For those working with legacy applications, you’ll also want to add a reference to MongoDB.Driver.Legacy.dll.