MongoDB C++ Driver

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 begin working with data in the Get Started with the C++ Driver tutorial.

Connect to MongoDB

Learn how to create and configure a connection to a MongoDB deployment in the Connect to MongoDB section.

Read Data from MongoDB

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

Write Data to MongoDB

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

Optimize Queries with Indexes

Learn how to work with common types of indexes in the Optimize Queries with Indexes section.

Transform Your Data with Aggregation

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

Secure Your Data

Learn about ways you can authenticate your application and encrypt your data in the Secure Your Data section.

Specialized Data Formats

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

Choose a C++17 Polyfill

Learn how to a choose a polyfill library implementation for pre-C++ 17 configurations in the Choose a C++17 Polyfill section.

Advanced Installation Options

Learn about advanced configuration and installation options in the Advanced Configuration and Installation Options section.

What's New

For a list of new features and changes in each version, see the What's New section.

Upgrade Driver Versions

Learn what changes you might need to make to your application to upgrade driver versions in the Upgrade Driver Versions section.

Issues & Help

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

Compatibility

For compatibility tables that show the recommended C++ driver version to use for specific C++ and MongoDB Server versions, see the Compatibility section.

API Documentation

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

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 the legacy documentation.

Current Driver

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

The mongocxx driver library includes a matching bson package, bsoncxx, that implements the BSON specification. This library can be used standalone for object serialization and deserialization even 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.