Skip to main content

Using mongosh with Tigris

mongosh is the MongoDB Shell. It is a fully functional JavaScript and Node.js 16.x REPL environment for interacting with MongoDB >= 4.0 compatible deployments.

Connect to Tigris

Create a Project in Tigris and take a note of Project Name, application key Client ID, and Client Secret.

We will use the Client ID and Client Secret from the output of the command above as the username and password in our MongoDB URI. We will use as the deployment to connect to.

mongosh mongodb://{TIGRIS_CLIENT_ID}:{TIGRIS_CLIENT_SECRET} --quiet --tls

You will see output similar to the following:


Note how you did not have to create a MongoDB Atlas cluster. is a serverless deployment with builtin automatic database sharding, meaning that, unlike MongoDB Atlas, you never have to worry about sharding or shard keys, and the data distribution is automatically handled.

Connect to the database

Assuming the name of the Tigris project you chose in the connect to Tigris step above is mongosh_quickstart, a database with that name would have been automatically created. Let's switch to this database.

use mongosh_quickstart

You will see output similar to following:

test> use mongosh_quickstart
switched to db mongosh_quickstart

Create a collection and insert a document

Let's create the collection podcasts and insert a document

title: 'The Polyglot Developer Podcast',
author: 'Nic Raboy',
tags: [ 'development', 'programming', 'coding' ]

This results in the following output:

mongosh_quickstart> db.podcasts.insertOne({ title: 'The Polyglot Developer Podcast', author: 'Nic Raboy', tags: [ 'development', 'programming', 'coding' ] })
acknowledged: true,
insertedId: ObjectId("63f8340c6fdb0db31a94bcbf")

We can see that the collection is created:

mongosh_quickstart> show collections

Read all documents in the collection

Let's now read the data in the collection:


This returns all the documents in the collection podcasts:

mongosh_quickstart> db.podcasts.find()
_id: ObjectId("63f8340c6fdb0db31a94bcbf"),
title: 'The Polyglot Developer Podcast',
author: 'Nic Raboy',
tags: [ 'development', 'programming', 'coding' ]

And that's all. Feel free to explore Deletes and Updates similarly.