- bsondump - display BSON files in a human-readable format
- mongoimport - Convert data from JSON, TSV or CSV and insert them into a collection
- mongoexport - Write an existing collection to CSV or JSON format
- mongodump/mongorestore - Dump MongoDB backups to disk in .BSON format, or restore them to a live database
- mongostat - Monitor live MongoDB servers, replica sets, or sharded clusters
- mongofiles - Read, write, delete, or update files in GridFS
- mongotop - Monitor read/write activity on a mongo server
Report any bugs, improvements, or new feature requests at https://jira.mongodb.org/browse/TOOLS
We currently build the tools with Go version 1.15. Other Go versions may work but they are untested.
go get to directly build the tools will not work. To build them, it's recommended to first clone this repository:
git clone https://github.com/mongodb/mongo-tools cd mongo-tools
./make build to build all the tools, placing them in the
bin directory inside the repository.
You can also build a subset of the tools using the
-tools option. For example,
./make build -tools=mongodump,mongorestore builds only
To use the build/test scripts in this repository, you must set GOROOT to your Go root directory. This may depend on how you installed Go.
Starting with version 100.3.1, the tools use
go mod to manage dependencies. All dependencies are listed in the
go.mod file and are directly vendored in the
In order to make changes to dependencies, you first need to change the
go.mod file. You can manually edit that file to add/update/remove entries, or you can run the following in the repository directory:
go mod edit -require=<package>@<version> # for adding or updating a dependency go mod edit -droprequire=<package> # for removing a dependency
go mod vendor -v to reconstruct the
vendor directory to match the changed
go mod tidy -v to ensure that the
go.mod file matches the
mongo-tools source code.
See our Contributor's Guide.
See the MongoDB packages documentation.
For documentation on older versions of the MongoDB, reference that version of the MongoDB Server Manual:
Adding New Platforms Support
See our Adding New Platform Support Guide.
Vendoring the Change into Server Repo
See our Vendor the Change into Server Repo.