Manage Clusters
On this page
Use the following resources to configure and manage Atlas clusters. These settings don't apply to Serverless instances.
Required Access
To view your clusters, you must have Project Read Only access
or higher to the project.
View Your Clusters
To list all clusters for your project using the Atlas CLI, run the following command:
atlas clusters list [options]
To return the details for the cluster you specify using the Atlas CLI, run the following command:
atlas clusters describe <clusterName> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas clusters list and atlas clusters describe.
To return the advanced configuration settings details for the cluster you specify using the Atlas CLI, run the following command:
atlas clusters advancedSettings describe <clusterName> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters advancedSettings describe.
To view all clusters in the Atlas UI, see View All Cloud Clusters. To view the details for a cluster, see View Cluster Details.
Select Cluster Tier
Select your preferred cluster tier. The cluster tier dictates the memory, storage, vCPUs, and IOPS specification for each data-bearing server [1] in the cluster.
Note
You might see different values depending on your selected cloud provider and region.
Shared and Flex Clusters
Use Flex clusters or Shared clusters as an economical way for getting started with MongoDB and for low-throughput applications. These clusters deploy to a shared environment with access to a subset of Atlas features. To learn more, see Limits.
You can deploy one M0 cluster (free sandbox replica set
cluster) per Atlas project. You can upgrade
an M0 Free cluster to a Flex cluster or Shared cluster
at any time.
Flex clusters and Shared clusters provide the
following added features compared to M0 clusters:
Backups for your cluster data
Increased storage
Considerations
Flex clusters and Shared clusters do not have the full availability of features found in Dedicated clusters. To learn more, see Limits.
Dedicated Clusters for Low-Traffic Applications
M10 and M20 cluster tiers support development environments
and low-traffic applications.
These clusters support replica set deployments only, but otherwise provide full access to Atlas features.
Note
M10 and M20 cluster tiers run on a burstable performance
infrastructure. Clusters under heavy load may experience CPU throttling.
Dedicated Clusters for High-Traffic Applications
M30 and higher clusters are recommended for production
environments.
These clusters support replica set and sharded cluster deployments with full access to Atlas features.
Some clusters have variants, denoted by the ❯ character. When you select these clusters, Atlas lists the variants and tags each cluster to distinguish their key characteristics.
NVMe Storage
For applications hosted on AWS or Azure that require low-latency and high-throughput I/O, Atlas offers storage options using locally attached ephemeral NVMe SSDs.
A File Copy Based Initial Sync will always be used to sync all of the nodes of an NVMe cluster whenever an initial sync is required.
Note
Atlas doesn't support NVMe clusters on Google Cloud.
NVMe Considerations
The following cluster tiers support NVMe clusters on AWS:
M40M50M60M80M200M400
The following cluster tiers support NVMe clusters on Azure:
M60M80M200M300M400M600
Atlas supports NVMe clusters in the following Azure regions:
Azure Region | Location | Atlas Region |
|---|---|---|
| São Paulo, Brazil |
|
| Toronto, ON |
|
| Iowa, USA |
|
| Virginia (East US) |
|
| Virginia, USA |
|
| Texas, USA |
|
| El Mirage, Arizona |
|
Azure Region | Location | Atlas Region |
|---|---|---|
| Paris, France |
|
| Ireland |
|
| Gävle, Sweden |
|
| London, England, UK |
|
| Netherlands |
|
Azure Region | Location | Atlas Region |
|---|---|---|
| New South Wales, Australia |
|
| Pune (Central India) |
|
| Saitama, Tokyo, Japan |
|
The fixed-value storage space and RAM for an NVMe cluster corresponds to its cluster tier. To learn more, see Amazon Cluster Configuration Options and Azure Cluster Configuration Options.
Clusters with NVMe storage use Cloud Backups. You can't disable backup on NVMe clusters. If you want to use hourly backups, Atlas limits backups on NVMe clusters to once every 12 hours.
NVMe clusters use a hidden secondary node that consists of a provisioned volume with high throughput and IOPS to facilitate backup.
You can't pause an NVMe cluster.
Scaling of clusters (including auto-scaling) that use the local NVMe SSD storage option requires an initial sync. Atlas NVMe clusters auto-scale to the next higher tier when 90% of the storage space is full. An initial sync takes longer to complete compared to subsequent syncs, and reduces the performance of the primary from which the data is read.
A File Copy Based Initial Sync will always be used to sync all of the nodes of an NVMe cluster whenever an initial sync is required.
NVMe Availability Zones
NVMe clusters in the following Azure regions have two Availability Zones:
eastus2centralussouthcentralus
NVMe clusters in all other Azure regions that indicate Availability Zones have three Availability Zones.
Free, Shared, Flex, and Dedicated Cluster Comparison
The following table highlights key differences between M0 Free
Tier clusters, M2 and M5 Shared clusters, Flex clusters, and
M10+ dedicated clusters.
Free Clusters | Shared Clusters | Flex Clusters | Dedicated Clusters | |
|---|---|---|---|---|
Storage (Data Size + Index Size) | 512 MB | M2: 2 GBM5: 5 GB | 5 GB | 10 - 4000 GB |
MongoDB Version Support | 8.0 | 8.0 | 8.0 | 5.0, 6.0, 7.0, and Latest Release |
Metrics and Alerts | Limited | Limited | Limited | Full metrics, including the Real Time Performance Tab, and full alert configuration options. |
VPC Peering | No | No | No | |
Global Region Selection | A subset of regions in AWS, Google Cloud, and Azure. | A subset of regions in AWS, Google Cloud, and Azure. | A subset of regions in AWS, Google Cloud, and Azure. | Atlas supports deploying clusters globally on Amazon Web Services, Google Cloud Platform, and Microsoft Azure. |
Cross-Region Deployments | No | No | No | |
Backups | No | Yes | ||
Sharding | No | No | No | Yes, for clusters using an |
Dedicated Cluster | No, | No, | No, Flex clusters run in a shared environment | Yes, |
Performance Advisor | No | No | No | Yes |
BI Connector for Atlas | No | No | No | Yes |
For a complete list of M0 Free cluster, M2, and M5 limitations,
see Atlas M0 (Free Cluster), M2, and M5 Limits.
To learn more, see Configure Auto-Scaling.
| [1] | For replica sets, the data-bearing servers are the servers hosting the replica set nodes. For sharded clusters, the data-bearing servers are the servers hosting the shards. For sharded clusters, Atlas also deploys servers for the config servers; these are charged at a rate separate from the cluster costs. |
Take the Next Steps
You can manage clusters in the following ways:
Action | Description |
|---|---|
Customize the storage capacity of your cluster. Each
cluster tier comes with a default set of resources. | |
Configure the cluster tier ranges that Atlas uses to automatically scale your cluster tier, storage capacity, or both in response to cluster usage. | |
Configure additional cluster settings such as MongoDB version, backup, and encryption options. | |
Use resource tags that you provide and manage to categorize resources by purpose, environment, team, or billing center. | |
Reconfigure an existing cluster. Modify any of the available Atlas configuration options. | |
Manage major version upgrades for your cluster. Atlas enables you to upgrade the major version of an Atlas cluster at any time. | |
Configure maintenance windows for your cluster. You can set the hour of the day that Atlas should start weekly maintenance on your cluster. | |
Pause, resume, or terminate an existing cluster. You can't change the configuration of a paused cluster. Also, you can't read data from or write data to a paused cluster. | |
Configure multi-cloud distribution for increased availability. Atlas offers options to improve the availability and workload balancing of your cluster. | |
Use pre-defined replica set tags that Atlas provides to
direct queries from specific applications to specific node types
and regions. To use pre-defined replica set tags in your
connection string and direct queries to specific nodes, set the
tag in the |