Installation

On this page

This section provides detailed instructions for installing dotConnect for MongoDB. It covers the standard installation via the Setup Wizard, NuGet package installation, and command-line installation, including silent and very silent modes.

Install using NuGet

You can install dotConnect for MongoDB using NuGet using either the Package Manager Console or NuGet Package Manager.

Install via the Package Manager Console

1. In Visual Studio, select the project where you want to install the package.

2. On the menu bar, select Tools > NuGet Package Manager > Package Manager Console.

3. In the Package Manager Console, execute the following command:


dotnet add package Devart.Data.MongoDB

Note To use dotConnect for MongoDB, you need to specify an activation key in the License Key connection string parameter, even for a trial version. To start a free 30-day trial, obtain your trial activation key. To use a purchased license, find your activation key in the email from Devart or on the Customer Portal. For more information, see Activation.

Install via the NuGet Package Manager

1. In Visual Studio, select the project where you want to install the Devart.Data.MongoDB package.

2. On the menu bar, select Tools > NuGet Package Manager > Manage NuGet Packages for Solutions.

3. On the Browse tab, choose the package and select your project. Then click Install.

4. In the Preview Changes dialog that opens, review the modifications that will be applied to your project after the package installation. Click Apply.

Installation via package manager preview changes

5. Read and accept the license agreement.

Installation via package manager license acceptance

6. Enter your activation key or upload the file that contains it, then click OK.

Note You must activate dotConnect for MongoDB even to use the trial version. To obtain the activation key, click Get Key from Customer Portal. If you don't have a license yet, an activation key for a free 30-day trial will be generated.

Installation via package manager activation key

Install via the Setup Wizard

1. Download dotConnect for MongoDB from the Devart website.

2. Locate the downloaded .exe file and double-click it to launch the installation wizard.

3. Follow the on-screen instructions in the Setup Wizard.

3.1. Read and accept the license agreement. Then click Next.

Installation via wizard - license agreement

3.2. Choose the installation folder or use the default location (C:\Program Files (x86)\Devart\dotConnect\MongoDB). Then click Next.

Installation via wizard - select destination

3.3. Select the components you want to install. Then click Next.

Installation via wizard - select components

Note Entity Developer is selected by default in the list of components. It is downloaded in the background during the provider installation, and its installation starts automatically once the main product installation is complete.
Entity Framework Core support is not included in the installer. To use Entity Framework Core, install the Devart.Data.MongoDB.EFCore NuGet package.

3.4. Select the Start Menu folder to save the provider's shortcuts. If you don't want to create the folder, select the Don't create a Start Menu folder checkbox. Then click Next.

Installation via wizard - start menu folder

3.5. Optional: Select additional tasks.

Install menu item and toolbox components into Visual Studio: Integrate the provider into the Visual Studio environment (Visual Studio 2017, 2019, 2022, and 2026), including menu entries and toolbox controls.
Do not install assemblies in the GAC: Keep assemblies local to the project instead of registering them in the Global Assembly Cache (GAC).

Click Next to continue.

Installation via wizard - additional tasks

3.6. Click Install and wait until the installation is complete.

Installation via wizard - installation ready

3.7. Select an activation mode.

Input Activation Key: Activate the product immediately by entering your activation key or uploading the file that contains the key.

Note You can find your activation key in the registration email or in your Customer Portal account.
To evaluate the product, sign in to the Customer Portal and obtain your 30-day trial activation key.

Activate later: Skip activation for now. You can activate the product later.

Click Next to continue.

Installation via wizard - license information

3.8. Click Finish.

Installation via wizard - completing setup

Install from the command line

dotConnect for MongoDB supports the following command-line installation modes: silent and very silent.

To install the provider from the command line using the preferred mode, follow these steps:

1. Download the installer.

2. Open Command Prompt as an administrator.

3. Navigate to the folder where the installer is located. The default path is:


%USERPROFILE%\Downloads

4. Run the installer with the required command-line arguments:

To install the provider in silent mode (without prompts but with the installation progress window), use the following command. The /DIR parameter specifies the installation folder on your computer.


dcmongodb.exe /SILENT /DIR="C:\Program Files\Devart\dotConnect\MongoDB"

Installation via command line - silent mode

To install the driver in very silent mode (completely in the background, without prompts or installation progress windows), use this command:


dcmongodb.exe /VERYSILENT /DIR="C:\Program Files\Devart\dotConnect\MongoDB"

Note You can optionally use the /disablegac parameter to keep assemblies local to the project instead of registering them in the Global Assembly Cache (GAC).


dcmongodb.exe /VERYSILENT /DIR="C:\Program Files\Devart\dotConnect\MongoDB" /disablegac

Native libraries

The installer places the native libraries required by the provider in the Native\win-x86 and Native\win-x64 subfolders of the installation folder:

libmongoc-1.0.dll and libbson-1.0.dll – MongoDB C driver 1.23.1.
sqlite3.dll.
vcruntime140.dll.

You don't need to install the Visual C++ runtime separately.

[email protected]