Docs Menu
Docs Home
/
MongoDB Atlas
/

Deploy a Free Cluster

On this page

  • Procedure
  • Next Steps

Estimated completion time: 3 minutes

Atlas free clusters provide a small-scale development environment to host your data. Free clusters never expire, and provide access to a subset of Atlas features and functionality.

Paid clusters provide full access to Atlas features, configuration options, and operational capabilities. For more information on paid clusters, including deployment instructions, see Create a Cluster.

Note

You can deploy only one free cluster per Atlas project.

You can create free clusters through the Atlas CLI, Atlas User Interface, and Atlas Administration API. Select the appropriate tab based on how you would like to create the free clusters.

To create one cluster, load sample data, add your IP address to your project IP access list, and create a MongoDB user for your cluster using the Atlas CLI, run the following command:

atlas setup [options]

To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas setup.

For step-by-step instructions on using this command, see Create and Configure an Atlas Cluster using the Atlas CLI.

Tip

See: Related Links

To create a free cluster using the Atlas Administration API, send a POST request to the clusters endpoint with the instanceSize set to M0. To learn more about the resource and parameters, see Create.

To create a free cluster through the Atlas UI:

Important

The following procedure applies to creating your very first cluster in the Atlas UI.

1

Complete any welcome prompts. If you're logging in for the first time, Atlas sometimes skips the next two steps.

2
  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 Overview page is not already displayed, click Overview in the sidebar.

3

Click the Create button to create a cluster.

4

M0 clusters are free forever and suitable for users learning MongoDB or developing small proof-of-concept applications.

5

Atlas supports M0 free clusters on Amazon Web Services (AWS), Google Cloud Platform (GCP), and Microsoft Azure.

6

Atlas displays only the cloud provider regions that support M0 free clusters.

7

You can specify any name for your cluster. The cluster name can contain ASCII letters, numbers, and hyphens.

You can't change the cluster name after Atlas deploys the cluster. Cluster names can't exceed 64 characters in length.

8

The Security Quickstart wizard appears.

To learn more about the security features available, see Configure Security Features for Clusters.

Once you deploy your cluster, it can take up to 10 minutes for your cluster to provision and become ready to use.

9
  1. Specify a Username for your database user.

  2. Specify a Password or copy the secure password that Atlas suggests.

  3. Click Create Database User.

10
  1. Click Add My Current IP Address.

  2. Click Finish and Close.

  3. Click Go to Overview.

Now that your cluster is provisioned, proceed to Manage the Database Users for Your Cluster.