Connect to Your Cluster

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Shell.

Click I do not have the MongoDB Shell installed.

Select your operating system from the dropdown.

Download the MongoDB Shell.

• If you are using Windows or Linux, download using one of the following options:

  • Click Download mongosh to begin the download.

  • Click Copy download URL to copy a download URL to your clipboard, then either:

    • Use curl to fetch the installer file, or

    • Paste the URL in a browser window.

  • Download the installer from the MongoDB Shell page.

• If you are using macOS, you can use the provided Homebrew command to download the shell.

Install the MongoDB Shell.

Select the appropriate tab based on your operating system:

You should now be able to run mongosh using your terminal.

Test your MongoDB Shell installation.

To see if you have correctly added mongosh to your system path, run the following command in your terminal:

mongosh --version

You should see an output similar to the following:

0.14.0

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Compass.

From the Connect Modal, click Compass.

Click I do not have MongoDB Compass. Select your operating system from the dropdown.

Click Download Compass (<version>).

Click Close after downloading Compass.

Open your terminal.

Install the PyMongo Driver.

Run the following command in your terminal:

python -m pip install "pymongo[snappy,gssapi,srv,tls]"

This command installs the PyMongo driver and a few dependencies for the driver. To learn more, see the Python Driver Installation Page on GitHub.

Test your PyMongo installation.

Test your PyMongo installation to ensure you can successfully connect to your cluster.

1. Run the following command to open the Python shell:

   python

2. Import PyMongo by running the following command in the Python shell:

   import pymongo

3. Check your PyMongo version using the following command:

   pymongo.version

   If PyMongo is correctly installed, you should see an output similar to the following:

   '3.11.0'

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Shell.

From the Connect Modal, click Shell.

Click I have the MongoDB Shell installed and select your mongosh version from the drop-down.

Copy the provided connection string to your clipboard.

This is a unique connection string specific to your Atlas cluster. Atlas replaces the username of the connection string with the username of the database user you created earlier in this procedure.

Paste and run your connection string in your terminal.

When prompted, enter your database user's password. You will be prompted to enter the password you specified when you created your database user in Atlas.

You should now be connected to your Atlas cluster within the mongosh. Your terminal should display something similar to the following:

MongoDB Enterprise GettingStarted-shard-0:PRIMARY>

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Get the Connection String for MongoDB Compass from Atlas.

1. Click I have MongoDB Compass.

2. Choose your version of MongoDB Compass in the dropdown. To check the version of MongoDB Compass that you have installed on your system, click About MongoDB Compass in the application.

3. Copy the connection string presented in the Atlas Connect dialog box.

Open MongoDB Compass and Connect to Atlas.

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Drivers.

From the Connect Modal, click Drivers.

Select C# / .NET from the Driver dropdown.

Select your version of the driver from the dropdown. The connection string displays.

Copy the provided connection string.

Configure the provided connection string.

Replace <password> with the password specified when you created your database user.

Connect with the sample application.

The following sample application connects to your Atlas cluster with your connection string and sends a ping to confirm a successful connection. To test the sample application:

1. Create a new directory called connect and initialize your project by using the dotnet new command.

   mkdir connect
   cd connect
   dotnet new console

2. Run the following command to add the .NET/C# Driver to your project as a dependency:

   dotnet add package MongoDB.Driver

3. Replace the contents of the Program.cs file with the following code. Make sure to replace the placeholder with your updated connection string:

   1
   using MongoDB.Bson;
   2
   using MongoDB.Driver;
   3
   4
   public class Connect
   5
   {
   6
     // Replace the following with your Atlas connection string               
   7
     private const string MongoConnectionString = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
   8
   9
     public static void Main(string[] args)
   10
     {
   11
       // Connect to your Atlas cluster
   12
       var client = new MongoClient(MongoConnectionString);
   13
   14
       // Send a ping to confirm a successful connection
   15
       try {
   16
           var result = client.GetDatabase("admin").RunCommand<BsonDocument>(new BsonDocument("ping", 1));
   17
           Console.WriteLine("Successfully connected to Atlas");
   18
       } 
   19
       catch (Exception e) { Console.WriteLine(e);}
   20
     }
   21
   }

4. To run your application, use the following command:

   dotnet run Program.cs

   HIDE OUTPUT

   Successfully connected to Atlas

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Drivers.

From the Connect Modal, click Drivers.

Select Go from the Driver dropdown.

Select your version of the driver from the dropdown. The connection string displays.

Copy the provided connection string.

Configure the provided connection string.

Replace <password> with the password specified when you created your database user.

Connect with the sample application.

The following sample application connects to your Atlas cluster with your connection string and sends a ping to confirm a successful connection. To test the sample application:

1. Create a new directory called connect and initialize your project by using the go mod command.

   mkdir connect
   cd connect
   go mod init connect

2. Run the following commands to download the Go driver and driver dependencies:

   go get go.mongodb.org/mongo-driver/mongo
   go get github.com/joho/godotenv

3. In your project, create a new file called connect.go and paste the following code. Make sure to replace the placeholder with your updated connection string:

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   7
   	"go.mongodb.org/mongo-driver/bson"
   8
   	"go.mongodb.org/mongo-driver/mongo"
   9
   	"go.mongodb.org/mongo-driver/mongo/options"
   10
   )
   11
   12
   func main() {
   13
   14
   	// Replace the following with your Atlas connection string               
   15
   	uri := "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
   16
   17
   	// Connect to your Atlas cluster
   18
   	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
   19
   	if err != nil {
   20
   		panic(err)
   21
   	}
   22
   	defer client.Disconnect(context.TODO())
   23
   24
   	// Send a ping to confirm a successful connection
   25
   	var result bson.M
   26
   	if err := client.Database("admin").RunCommand(context.TODO(), bson.D{{"ping", 1}}).Decode(&result); err != nil {
   27
   		panic(err)
   28
   	}
   29
   	fmt.Println("Successfully connected to Atlas")
   30
   }

4. To run your application, use the following command:

   go run connect.go

   HIDE OUTPUT

   Successfully connected to Atlas

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Drivers.

From the Connect Modal, click Drivers.

Select Java from the Driver dropdown.

Select your version of the driver from the dropdown. The connection string displays.

Copy the provided connection string.

Configure the provided connection string.

Replace <password> with the password specified when you created your database user.

Connect with the sample application.

The following sample application connects to your Atlas cluster with your connection string and sends a ping to confirm a successful connection. To test the sample application, copy the following code into a file called Connect.java.

Replace the placeholder with your updated connection string:

1
import com.mongodb.*;
2
import org.bson.BsonDocument;
3
import org.bson.BsonInt64;
4
import org.bson.Document;
5
import org.bson.conversions.Bson;
6
7
import com.mongodb.client.MongoClient;
8
import com.mongodb.client.MongoClients;
9
import com.mongodb.client.MongoDatabase;
10
11
public class Connect {
12
    public static void main(String[] args) {
13
        // Replace the placeholder with your Atlas connection string
14
        String uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
15
16
        // Construct a ServerApi instance using the ServerApi.builder() method
17
        ServerApi serverApi = ServerApi.builder()
18
                .version(ServerApiVersion.V1)
19
                .build();
20
21
        MongoClientSettings settings = MongoClientSettings.builder()
22
                .applyConnectionString(new ConnectionString(uri))
23
                .serverApi(serverApi)
24
                .build();
25
26
        // Create a new client and connect to the server
27
        try (MongoClient mongoClient = MongoClients.create(settings)) {
28
            MongoDatabase database = mongoClient.getDatabase("admin");
29
            try {
30
                // Send a ping to confirm a successful connection
31
                Bson command = new BsonDocument("ping", new BsonInt64(1));
32
                Document commandResult = database.runCommand(command);
33
                System.out.println("Successfully connected to Atlas");
34
            } catch (MongoException e) {
35
                System.err.println(e);
36
            }
37
        }
38
    }
39
}

Compile and run the Connect.java file by using an IDE or the following commands:

javac Connect.java
java Connect

Successfully connected to Atlas

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Drivers.

From the Connect Modal, click Drivers.

Select Node.js from the Driver dropdown.

Select your version of the driver from the dropdown. The connection string displays.

Copy the provided connection string.

Configure the provided connection string.

Replace <password> with the password specified when you created your database user.

Connect with the sample application.

The following sample application connects to your Atlas cluster with your connection string and returns a confirmation message. To test the sample application, copy the following code into a file called connect.js.

Replace the placeholder with your updated connection string:

1
const { MongoClient } = require("mongodb");
2
 
3
// Replace the following with your Atlas connection string                                                                                                                                        
4
const url = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
5
6
// Connect to your Atlas cluster
7
const client = new MongoClient(url);
8
9
async function run() {
10
    try {
11
        await client.connect();
12
        console.log("Successfully connected to Atlas");
13
14
    } catch (err) {
15
        console.log(err.stack);
16
    }
17
    finally {
18
        await client.close();
19
    }
20
}
21
22
run().catch(console.dir);

To run the sample application, use the following command:

node connect.js

Successfully connected to Atlas

In Atlas, go to the Clusters page for your project.

1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

3. If it's not already displayed, click Clusters in the sidebar.

   The Clusters page displays.

Click Connect.

Click Connect for the cluster to which you want to connect.

Click Drivers.

From the Connect Modal, click Drivers.

Select Python and your version of the driver.

The connection string displays.

Copy the provided connection string.

Configure the provided connection string.

Replace <password> with the password specified when you created your database user.

Import MongoClient from PyMongo.

To connect to a running MongoDB instance, PyMongo requires MongoClient. In the Python shell running in your terminal, run the following command to import MongoClient:

from pymongo import MongoClient

Connect to your cluster.

Create the command that specifies a client for connecting to your cluster.

1. In your Python shell, paste your updated connection string into the following command:

   client = MongoClient('<connection-string>')

2. Update the connection string with your database user password.

3. Verify that you have enclosed the connection string in single quotes.

4. Run the resulting command. It specifies a client that will connect to your cluster.

5. Connect to your cluster using this client.