Overview

Welcome to the documentation site for the official MongoDB C++ Driver.

Get Started

Learn how to install the driver, establish a connection to MongoDB, and beginworking with data in theGet Started with the C++ Driver tutorial.

Connect to MongoDB

Learn how to create and configure a connection to a MongoDB deploymentin theConnect to MongoDB section.

Read Data

Learn how you can retrieve data from MongoDB in theRead Data section.

Write Data to MongoDB

Learn how you can write data to MongoDB in theWrite Data to MongoDB section.

Databases and Collections

Learn how to use the C++ driver to work with MongoDB databases and collections in theDatabases and Collections section.

Optimize Queries with Indexes

Learn how to work with common types of indexes in theOptimize Queries with Indexessection.

Transform Your Data with Aggregation

Learn how to use the C++ driver to perform aggregation operations in theTransform Your Data with Aggregation section.

Secure Your Data

Learn about ways you can authenticate your application and encrypt your data intheSecure Your Data section.

Specialized Data Formats

Learn how to work with specialized data formats and custom types in theSpecialized Data Formats section.

Advanced Installation Options

Learn about advanced configuration and installation optionsin theAdvanced Configuration and Installation Options section.

Include and Link the Driver in Your Program

Learn how to include and link the driver in your programin theInclude and Link the Driver in Your Program section.

What's New

For a list of new features and changes in each version, see theWhat's Newsection.

Upgrade Driver Versions

Learn what changes you might need to make to your application to upgrade driver versionsin theUpgrade Driver Versions section.

Issues & Help

Learn how to report bugs, contribute to the driver, and find help in theIssues & Help section.

Compatibility

For compatibility tables that show the recommended C++ driverversion to use for specific C++ and MongoDB Server versions, seeCompatibility.

API Documentation

For detailed information about types and methods in the C++ driver, seetheC++ driver API documentation.

C++17 Polyfill Configuration

The MongoDB C++ Driver uses C++17 featuresstd::optional<T> andstd::string_view.If you configure the driver with a pre-C++17 standard, the bsoncxx library providespolyfill implementations for these C++17 features. The driver uses the bsoncxx polyfillimplementations when theCMAKE_CXX_STANDARD configuration option is set to a numberless than17. By default, this option is set to11.

Driver Status by Family and Version

Stability indicates whether this driver is recommended for production use.Currently, no drivers guarantee API or ABI stability.

For documentation about previous releases, see thelegacy documentation.

Current Driver

The mongocxx is a ground-up rewrite of a C++ driver for MongoDB based onlibmongoc. It requires a C++11 compiler. It isknown to build on x86 and x86-64 architectures for Linux, macOS,Windows, and FreeBSD.

The mongocxx driver library includes a matching bson package, bsoncxx, thatimplements theBSON specification. Thislibrary can be used standalone for object serialization and deserializationeven when one is not using MongoDB at all.

Releases of the mongocxx driver have version numbers like v3.x.y.

License

MongoDB C++ drivers are available under the terms of the Apache License, version 2.0.