Introducing Dragonfly Cloud! Learn More

Question: What is the difference between a MongoDB project and a cluster?


In MongoDB Atlas, both projects and clusters are fundamental concepts, but they serve different purposes within the platform's architecture.

MongoDB Project

A project in MongoDB Atlas acts as an organizational unit that groups together your MongoDB clusters. Projects help you organize your databases based on team, application, or environment. Within a single project, you can have multiple clusters. Projects also come with their own set of permissions and settings. This means you can control access at the project level, determining who can see or manipulate the clusters and data within.

Features of projects include:

  • Grouping of clusters for better organization.
  • Specific user roles and permissions.
  • Dedicated alert settings.
  • Integration with third-party services and tools.

MongoDB Cluster

A cluster, on the other hand, refers to the actual MongoDB database instance or group of instances. Clusters hold your collections, documents, and data. In MongoDB Atlas, you can choose between different types of clusters like replica sets (for high availability) or sharded clusters (for horizontal scaling).

Key aspects of clusters include:

  • Storage of data in collections and documents.
  • Configuration options for size, region, and more.
  • Backup and restoration functionalities.
  • Performance monitoring tools.

Key Differences

  • Scope: A project is a higher-level organizational unit that can contain multiple clusters, while a cluster specifically refers to the database instance(s).
  • Purpose: Projects are used for managing and organizing access, alerts, and integrations at a broader level. Clusters directly deal with storing and managing your data.
  • Permissions: Access control can be managed at the project level, affecting all clusters within that project, whereas cluster-specific settings focus on operational parameters like storage, compute resources, and geographical distribution.

In summary, when working with MongoDB Atlas, it's important to understand that a project serves as an organizational container for your clusters, providing a level of abstraction for managing access and configurations. Clusters are the actual database environments where your data lives and is operated upon.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book

Start building today 

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.