You can get started with Atlas via the Atlas CLI using a single
This tutorial demonstrates how to use
atlas setup to:
Sign up for an Atlas account.
Authenticate with the new Atlas account.
Create one free database.
Load sample data into your Atlas database.
Add your IP address to your project's IP access list.
Create a MongoDB user for your Atlas database deployment.
Connect to your new database deployment using the MongoDB Shell,
You can also run
atlas setup if you have an Atlas account and
an organization/project but you haven't set up a cluster.
Before you begin, you must install the Atlas CLI.
Complete the following procedure to get started with Atlas.
After you run the command, enter Y to open the default browser. A browser window displays the Create Your Account screen.
If you want to log into an existing Atlas account, click Log in now and log in.
If you're already logged into an existing Atlas account, proceed to step 3.
After you verify your Atlas CLI session,
M0 clusters have some operational
If you log into an existing account and have existing
organizations and projects,
atlas setup prompts you to select
a default organization and default project. Select a default
organization and project and press
When the Atlas CLI prompts
Do you want to set up
your first free database in Atlas with default
settings? It's free forever!, enter Y to create your cluster with the default settings.
The command creates a sample
M0 shared-tier cluster with the
following default settings:
Cloud provider and region:
AWS - US_EAST_1
Database User Password:
Load Sample Data:
Allow connection from IP:
Do you want to set up your first free database in Atlas with default settings? It's free forever! Y
We are deploying Cluster9876543... Please store your database authentication access details in a secure location. Database User Username: Cluster9876543 Database User Password: abcdef12345 Creating your cluster... [Its safe to 'Ctrl + C']
Congratulations! You have successfully set up your Atlas account.
To view the status of your cluster, run the atlas clusters command.