MongoDB

❖ Welcome to Param Classes!

In modern web development, applications often need a database that can be accessed from different locations. A local database is useful during development, but when you want to build a cloud-based application, you may need a database that is hosted online.

MongoDB Atlas is a cloud database service that allows developers to create, manage, and access MongoDB databases through the internet. You do not need to maintain your own database server on your computer. Instead, MongoDB Atlas provides a managed cloud environment where you can store application data.

In this beginner-friendly tutorial by Param Classes, you will learn how to create a MongoDB Atlas account, set up a free-tier cluster where available, configure database access, connect MongoDB Compass, and create your first cloud database.

✦ 1. What Is MongoDB Atlas?

MongoDB Atlas is a cloud-based database platform for hosting MongoDB databases. It allows developers to store application data online and connect their applications to the database using a connection string.

For example, imagine you are developing a student management system. You want to store student names, mobile numbers, courses, and addresses. Instead of keeping the database only on your computer, you can use MongoDB Atlas to host it in the cloud.

Some important features of MongoDB Atlas are:

• Cloud-based database hosting.

• Managed database infrastructure.

• Database access through connection strings.

• Security settings for users and network access.

• Integration with MongoDB Compass.

• Monitoring and database management tools.

• Options to scale resources according to application requirements.

Atlas offers different plans and configurations. Availability, limits, and pricing can change, so check the current plan details before selecting a cluster.

✦ 2. MongoDB Local Database vs MongoDB Atlas

Before creating an Atlas account, understand the difference between a local MongoDB database and a cloud database.

Local MongoDB	MongoDB Atlas
Runs on your computer or local server	Hosted on cloud infrastructure
Usually accessed through localhost	Accessed using a cloud connection URI
Requires local server installation	Atlas manages the database infrastructure
Useful for local development	Useful for cloud-based applications
Access depends on your local setup	Access depends on network and database permissions

Both options use MongoDB. You can practise locally and later connect your application to Atlas when you are ready to work with a cloud database.

✦ 3. Create a MongoDB Atlas Account

The first step is to create an account on the official MongoDB website.

Step 1: Open the official MongoDB Atlas website:

https://www.mongodb.com/atlas

Step 2: Find the option to get started or create an account.

Step 3: Register using an email address or an available sign-in option.

Step 4: Complete the required account verification steps.

Step 5: Sign in to the MongoDB Atlas dashboard.

After login, Atlas may ask you to provide basic information about your project or intended use. Follow the on-screen instructions to complete the initial setup.

You should now be able to access the Atlas dashboard and begin creating your cloud database environment.

✦ 4. Create Your First MongoDB Atlas Cluster

A cluster is the cloud database deployment where your MongoDB data is stored. Atlas provides different deployment options depending on your requirements and plan.

For learning purposes, select an eligible free-tier option if it is currently available in your account and region.

Step 1: Open your Atlas project dashboard.

Step 2: Find the option to create a database or deploy a database.

Step 3: Select an available cluster or deployment option suitable for learning.

Step 4: Choose a cloud provider and region from the available choices.

Step 5: Give your deployment a meaningful name, such as:

ParamClassesCluster

Step 6: Review the selected configuration and create the deployment.

Atlas will take some time to provision your database deployment. Wait until its status indicates that it is ready.

Important: Cloud providers, regions, cluster options, and free-tier availability may vary. Always review the current configuration and pricing before creating a paid deployment.

✦ 5. Configure Database Access in MongoDB Atlas

After creating a cluster, you need to configure database access. MongoDB Atlas uses database users and permissions to control who can connect to your database.

A database user is different from the email account you use to log in to the Atlas website.

Follow these steps:

Step 1: Open your Atlas project.

Step 2: Navigate to the Database Access section. Its location or label may vary slightly with dashboard updates.

Step 3: Choose the option to add a new database user.

Step 4: Enter a username, for example:

param_student

Step 5: Set a strong password.

Step 6: Assign only the permissions required for your learning project. For a beginner exercise, select an appropriate read and write role for the intended database scope.

Step 7: Save the database user.

Keep your username and password secure. Do not share them publicly or paste real credentials into blog posts, screenshots, or public repositories.

✦ 6. Configure Network Access

MongoDB Atlas also checks where a connection is coming from. This is controlled through the Network Access settings.

Follow these steps:

1. Open the Network Access section in your Atlas project.

2. Choose the option to add an IP address.

3. Add your current public IP address.

4. Save the configuration.

5. Wait for the change to become active.

Your current IP address may change when you switch networks or use a different internet connection. If that happens, you may need to update the access list.

Security Tip: Avoid allowing access from every IP address as a permanent setting. Broad network access can expose your database to unnecessary connection attempts. Use the narrowest access rule suitable for your application and development environment.

✦ 7. Connect MongoDB Atlas with MongoDB Compass

Now let's connect your cloud database to MongoDB Compass.

MongoDB Compass is a graphical tool that lets you view databases, collections, and documents without writing every command manually.

Step 1: Open MongoDB Atlas.

Step 2: Go to your database deployment and find the Connect option.

Step 3: Select the connection method for MongoDB Compass.

Step 4: Follow the instructions to copy the connection string.

Step 5: Open MongoDB Compass on your computer.

Step 6: Paste the copied connection string into the connection field.

The URI will look similar to this example:

mongodb+srv://<username>:<password>@<cluster-address>/

Replace the placeholders with your actual database username, password, and cluster address. Use the connection URI supplied by Atlas rather than copying this example literally.

If your password contains special characters, it may need URL encoding before being placed in the URI.

Step 7: Click Connect.

If your credentials and network access are configured correctly, Compass should connect to your Atlas deployment.

✦ 8. Create a Database and Collection in MongoDB Atlas

After connecting Compass, let's create a practical database.

For this example, we will create a database for a college student management system.

Database name:

college

Collection name:

students

Follow these steps:

1. Open your connected Atlas deployment in Compass.

2. Find the option to create a database.

3. Enter college as the database name.

4. Enter students as the collection name.

5. Click Create Database.

Your database structure will look like this:

college
   |
   └── students

The college database stores college-related information, while the students collection stores individual student documents.

✦ 9. Insert Your First Student Document

Now we will insert a student record into the cloud database.

Open the students collection in Compass and choose the Insert Document option.

Enter this example document:

{
  "name": "Rahul Kumar",
  "age": 22,
  "course": "MongoDB",
  "city": "Raipur",
  "status": "Active"
}

Click Insert to save the document.

Your student information is now stored in your MongoDB Atlas database.

You can insert more documents to practise working with multiple records:

{
  "name": "Priya Sharma",
  "age": 21,
  "course": "Python",
  "city": "Bilaspur",
  "status": "Active"
}

These are sample records for learning purposes. You can use your own test data while practising.

✦ 10. Retrieve Data Using MongoDB Compass Filter

Suppose you want to find all students who are enrolled in the MongoDB course.

Open the Filter field in Compass and enter:

{
  "course": "MongoDB"
}

Apply the filter to display matching documents.

You can also search for students from Raipur:

{
  "city": "Raipur"
}

To find active students, use:

{
  "status": "Active"
}

Filters help you retrieve only the records that match your requirements. As you progress, you can learn more advanced MongoDB query operators.

✦ 11. Connect Your Application to MongoDB Atlas

MongoDB Atlas is not limited to Compass. You can also connect your application to the cloud database using an official MongoDB driver.

For example, a Node.js application can connect using the MongoDB Node.js driver.

A simplified connection example is:

const { MongoClient } = require("mongodb");

const uri = process.env.MONGODB_URI;

const client = new MongoClient(uri);

async function connectDB() {
    try {
        await client.connect();
        console.log("MongoDB Atlas Connected Successfully");

        const database = client.db("college");
        const students = database.collection("students");

        console.log("Students collection is ready");

    } catch (error) {
        console.error("Database connection failed:", error);
    }
}

connectDB();

In this example, the connection URI is read from an environment variable named MONGODB_URI.

Do not hardcode your real Atlas username or password in application code. Store the connection string securely in environment variables and do not upload secret configuration files to public repositories.

✦ 12. Common MongoDB Atlas Connection Problems

Beginners may encounter errors while connecting to Atlas. Here are some common problems and their solutions.

❖ Authentication Failed

This can happen when the database username or password is incorrect.

Solution: Check the database user details in the Database Access section. Remember that your Atlas website login and database credentials are different.

❖ IP Address Not Allowed

This error can appear when your current public IP address is not permitted.

Solution: Open Network Access and add your current IP address.

❖ Incorrect Connection String

A missing cluster address, incorrect URI, or unencoded special character in the password can cause connection problems.

Solution: Copy the latest connection string from Atlas and verify the placeholders and credentials.

❖ Cluster Is Not Ready

A newly created deployment may need time before it becomes available.

Solution: Check the deployment status in your Atlas dashboard and try again when it is ready.

❖ Compass Cannot Connect

The problem may be related to network access, credentials, DNS resolution, or the connection URI.

Solution: Check each setting carefully and follow the error message to identify the cause.

✦ 13. Important MongoDB Atlas Security Best Practices

When working with a cloud database, security should always be a priority.

Follow these basic practices:

• Use strong and unique database passwords.

• Give database users only the permissions they need.

• Restrict network access to trusted IP addresses.

• Never publish your connection string with real credentials.

• Store passwords and connection URIs in environment variables or a secure secret manager.

• Remove unused database users and access rules.

• Review your database deployment and billing settings regularly.

• Take backups according to your data protection requirements.

These practices are important even when you are using a learning or development database.

✦ 14. Practice Task: Build a Student Database

Now it is time to practise what you have learned.

Create a database named college and a collection named students.

Insert at least five sample student documents with these fields:

• Student Name

• Age

• Course

• City

• Mobile Number

• Status

Then complete these tasks:

1. Find all students from Raipur.

2. Find students enrolled in Python.

3. Update one student's course.

4. Change one student's status.

5. Delete a sample document after verifying the selected record.

6. Connect to the same Atlas deployment using MongoDB Compass.

This exercise will help you understand how a cloud database works in a practical environment.

✦ Conclusion

MongoDB Atlas makes it possible to host and manage MongoDB databases in the cloud. In this tutorial, you learned how to create an Atlas account, configure a cluster, add a database user, set network access, connect MongoDB Compass, create a database, insert documents, and retrieve information using filters.

These are important skills for developers who want to build real-world applications using MongoDB.

At Param Classes, we believe that programming becomes easier when you learn concepts through practical examples. Keep practising these MongoDB operations and gradually connect your cloud database with Node.js, Express.js, Python, or PHP applications.

Learn Today, Grow Tomorrow — Param Classes.