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.
Family/version | Stability | Development | Purpose |
---|---|---|---|
(repo master branch) | Unstable | Active development | New feature development |
mongocxx 3.11.x | Stable | Bug fixes only | Current stable C++ driver release |
mongocxx 3.10.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.9.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.8.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.7.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.6.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.5.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.4.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.3.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.2.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.1.x | Stable | None | Previous stable C++ driver release |
mongocxx 3.0.x | Stable | None | Previous stable C++ driver release | |
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.
Note
There were no v2.x.y C++ drivers to avoid confusion with the deprecated legacy-0.0-26compat-2.x.y drivers.
How to get help
Ask questions on our MongoDB Community Forums.
Visit our Support Channels.
See how to report a bug.
License
MongoDB C++ drivers are available under the terms of the Apache License, version 2.0.