Welcome to MongoDB Shell (mongosh)
The MongoDB Shell, mongosh, is a JavaScript and Node.js REPL
environment for interacting with MongoDB deployments in
Atlas , locally,
or on another remote host. Use the MongoDB Shell to test queries and
interact with the data in your MongoDB database.
_Spot.webp 300w,
/docs/mongodb-shell/static/eae135c0f0cfa35b46dd20c7255a082a/aa69f/Technical_SOFTWARE_Terminal(3)_Spot.webp 600w,
/docs/mongodb-shell/static/eae135c0f0cfa35b46dd20c7255a082a/a4bae/Technical_SOFTWARE_Terminal(3)_Spot.webp 1200w)
Access MongoDB From Your Shell
Find Your Connection String
Find your connection string. The connection string varies depending on the type of deployment you're connecting to.
Learn how to find your connection string for Atlas.
Or connect to a self-hosted deployment.
Insert Documents
mongosh supports common insert opererations,
including:
db.collection.find()method to query documents in a collection. For more information and examples, refer to Query Documents.
Update Documents
mongosh supports common update operations,
including:
For more information and examples, refer to Update Documents.
Delete Documents
mongosh supports common delete operations,
including:
For more information and examples, refer to Delete Documents.
Run Aggregation Pipelines
You can run aggregation pipelines in mongosh
using the db.collection.aggregate() method.
Aggregation pipelines transform your documents into
aggregated results based on the stages you specify. For more
information and examples, refer to
Manage Databases and Collections
View information about databases, create collections or views, or drop databases - all from your shell. See all Database Methods.
Perform collection operations, create or delete indexes, or explain queries with replication or sharding conveniently in your shell.
Check server status with a variety of Server Status Methods.
Manage Users and Roles
Create or update roles, define and update privileges, or drop roles using Role Management Methods.
Create and update users, authenticate users, and manage user roles with
_Spot.webp 588w,/docs/mongodb-shell/static/a04f36ac1e50d7815e17db949c913088/241a1/Technical_SOFTWARE_Terminal(1)_Spot.webp 588w,/docs/mongodb-shell/static/a04f36ac1e50d7815e17db949c913088/dc9ac/Technical_SOFTWARE_Terminal(1)_Spot.webp 1176w){kind=link}
Run Scripts for CRUD or Administrative Tasks
Write scripts to run with the MongoDB Shell that perform CRUD or administrative operations in MongoDB.
For example, if you have a JS file that seeds synthetic or mock data into MongoDB in your development or staging environment, run the file with:
mongosh YOUR_JS_FILENAME.js
Explore a tutorial that uses the MongoDB Shell with JavaScript to access MongoDB: Write Scripts.
Create Custom Helper Functions with .mongoshrc
Repeatedly writing large helper functions in the Shell? Store
them in a .mongoshrc config file. For
example, if you often find yourself converting date strings to
ISO format for queries, create a function in .mongoshrc to
handle it:
function toISO(dateString) { return new Date(dateString).toISOString(); }
Then, call the function in mongosh:
db.clientConnections.find( { connectTime: toISO("06/07/2017") } )
For more information, refer to Pull existing snippets into your codebase for convenient reuse. Or create and share snippets for your custom use case.
For example, you might have a snippet that validates the data you import daily as a cron job. You can publish this snippet, so your development team can access it. Publish to a community registry or configure a private registry.
For more information, refer to
_Spot.webp 588w,/docs/mongodb-shell/static/c1bf4b9bea0c3ddcfae2c8c1166eb001/241a1/Technical_SOFTWARE_Terminal(4)_Spot.webp 588w,/docs/mongodb-shell/images/mongosh-plp/icons/Technical_REALM_CLI10x.png){kind=link}