Docs Menu

Docs Home → MongoDB Atlas

Create a Global Cluster

On this page

  • Required Access
  • Considerations
  • Procedure

This section covers enabling Global Writes on an Atlas cluster.

Required Access

To create to a Global Cluster, you must have Organization Owner or Project Owner access to the project.

Considerations

  • Before creating a Global Cluster, review Global Clusters Overview and Global Clusters Sharding Reference.

  • You can enable Global Writes in Atlas when you deploy an M30 or greater sharded cluster.

  • After you deploy the cluster, you can't convert a Global Cluster to a standard sharded cluster.

  • Due to sharding requirements, you can't load sample data onto a Global Cluster.

  • If this is the first dedicated paid cluster for the selected region or regions and you plan on creating one or more VPC peering connections, review VPC Peering Connections before continuing.

Procedure

1

Navigate to the Database Deployments page for your project.

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

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

  3. If the Database Deployments page is not already displayed, click Database in the sidebar.

2

Open the Create New Database Deployment Dialog.

  • If you already have one or more database deployments, click Create to display the Create New Database Deployment dialog.

  • If this is your first database deployment:

    1. Click Build a Database.

    2. Click advanced configuration options at the top of the screen to display the Create New Database Deployment dialog.

3

Enable Global Writes for your cluster.

  1. In the Create New Cluster dialog box, select the Dedicated cluster type. For more information, see Create a Cluster.

  2. Click Global Cluster Configuration to expand the section.

  3. Toggle Enable Global Writes (M30 and Up) to On to display the Global Cluster configuration.

4

Select your preferred cloud provider.

Note

Each cloud provider has a selection of global regions to which Atlas can deploy a zone. The choice of cloud provider may support or constrict your ability to deploy a zone to specific geographic locations. The configuration options available and the cost for running the cluster may also vary depending on cloud provider selection.

5

Configure your Global Cluster Zones.

Atlas provides three options for configuring your Global Cluster zones:

  • Configure Global Writes Zones Using a Template

  • Configure a Global Writes Single Region Zone

  • Configure a Global Writes Multi Region Zone

Select the appropriate tab based on how you would like to configure your Global Cluster zones.

6

Select the Cluster Tier.

To use Global Clusters, you must select a cluster tier that is M30 or larger.

The selected tier dictates the memory, storage, vCPUs, and IOPS specification for each data-bearing server in the cluster.

For more information on how to select an appropriate cluster tier and storage settings for your workload, see Select Cluster Tier and Customize Cluster Storage.

7

Select any Additional Settings.

From the Additional Settings section for Global Clusters, you can:

8

Specify the Cluster Name.

This is the cluster name as it appears in Atlas. You can't change the cluster name once Atlas deploys the cluster.

Cluster names can't exceed 64 characters in length.

Important

Atlas truncates the cluster name to 23 characters in its internal interactions. In practice, this means:

  • Cluster names shorter than 23 characters can't end with hyphen or dash (-).

  • Cluster names 23 characters or longer can't use a hyphen or dash (-) as its 23rd character.

  • The first 23 characters in a cluster name must be unique within a project.

Don't include sensitive information in your cluster name.

9

Proceed to checkout.

Click Create Cluster below the form and complete the billing information only if it doesn't already exist. If your organization already has the billing information, Atlas deploys your cluster.

10

Optional: Update your Billing Address details as needed.

Field
Necessity
Action
Billing Email Address
Optional

Type the email address to which Atlas should send billing alerts.

By default, Atlas sends billing alerts to the Organization Owners and Billing Admins.

  • If you leave the Billing Email Address blank, Atlas sends billing alerts to the Organization Owners and Billing Admins.

  • If you specify a billing email address and uncheck Only send invoice emails to the Billing Email Address, Atlas sends billing alerts to the billing email address, Organization Owners, and Billing Admins.

  • If you specify a billing email address and check the box for Only send invoice emails to the Billing Email Address, Atlas send billing alerts to the billing email address only.

Company Name
Optional
Type the name of the company for your billing address.
Country
Required
Select the country for your billing address. You can also start typing the name of the country and then select it from the filtered list of countries.
Street Address
Required
Type the street address for your billing address.
Apt/Suite/Floor
Optional
Type an the apartment, suite, or floor for your billing address.
City
Required
Type the name of the city for your billing address.
State/Province/Region
Required

Type or select the political subdivision in which your billing address exists. The label and field change depending on what you selected as your Country:

  • If you select United States as your Country, this label changes to State. The field changes to a dropdown menu of U.S. states. You can also start typing the name of the state and then select it from the filtered list of states.

  • If you select Canada as your Country, this label changes to Province. The field changes to a dropdown menu of Canadian provinces. You can also start typing the name of the province and then select it from the filtered list of provinces.

  • If you select any other country as your Country, this label changes to State/Province/Region. The field changes to a text box. Type the name of your province, state, or region in this box.

ZIP or Postal Code
Required
Type the ZIP (U.S.) or Postal Code (other countries) for your billing address.
VAT Number
Conditional

Atlas displays the VAT ID field if you select a country other than the United States.

To learn more about VAT, see VAT ID.

If your company's billing address is in a country other than the United States (USA), Atlas typically charges VAT if you do not enter a valid VAT ID Number on your billing profile.

Important

If your billing address is in Ireland or certain Canadian provinces, Atlas always charges VAT, even with a valid VAT ID Number.

To learn more about VAT by region, see International Usage and Taxation.

11

Optional: Update your Payment Method details as needed.

  1. Click the radio button for Credit Card or Paypal.

    • If you selected Credit Card, type values for the following fields:

      Field
      Necessity
      Action
      Name on Card
      Required
      Type the name that appears on your credit card.
      Card Number
      Required
      Type the 16-digit number that appears on your credit card. American Express uses a 15-digit number.
      Expiration Date
      Required
      Type the expiration date for your credit card in the two-digit month and two-digit year format.

      CVC

      Required
      Type the three-digit number on the back of your credit card. American Express uses a 4-digit number found on the front of the credit card.

    • If you selected PayPal:

      1. Click Pay with PayPal.

      2. Complete the actions on the PayPal website.

All projects within your organization share the same billing settings, including payment method.

12

Review project's cost.

Under the Cart section, review the following:

Field
Description
Cluster Tier
Displays cost for your selected cluster tier and configuration details. To learn more, see Cloud Service Provider and Region and Cluster Tier.
Included Features
Displays features included with your selected cluster configuration.
Additional Settings
Displays additional settings that you enabled, such as cloud backups, sharding, BI Connector, and more. To learn more, see Cloud Backups.
13

Deploy your cluster.

Click Confirm and Deploy Cluster below the form to deploy your cluster.

Important

Each Atlas project supports up to 25 database deployments. Please contact Atlas support for questions or assistance regarding the database deployment limit. To contact support, select Support from the left-hand navigation bar of the Atlas UI.

14

Shard a global collection.

After deployment, you must configure shard keys for the cluster. To learn how to shard a collection for global writes, see Shard a Global Collection.

Tip

See also:

←  Create a Serverless InstanceCloud Providers and Regions →

On this page

Share Feedback