Docs Menu
Docs Home
/
Atlas
/
Get Started

Create an Atlas Account

On this page

  • Considerations
  • Prerequisites
  • Register a new Atlas Account
  • Log in to Your Atlas Account
  • Create an Atlas Organization and Project
  • Next Steps

Estimated completion time: 5 minutes

Register for an Atlas account using your GitHub account, your Google account or your email address.

Considerations

To register with and log in to Atlas, you can use one -- and only one -- of the following options:

  • Your email account

  • Your GitHub account

  • Your Google account

Note

If your company uses Federated Authentication, you must use your company email address.

GitHub Accounts

If you register with your GitHub Account, the following differences apply when using your GitHub account with Atlas:

  • GitHub manages your user details, email address, and password. You can't change this information using the Atlas console or API.

  • GitHub manages your 2FA. You can't use Atlas multi-factor authentication and won't be prompted for an Atlas 2FA verification when you log into Atlas. GitHub should verify your identity using GitHub 2-Step Verification.

  • If you linked your Atlas account to your GitHub Account, you can unlink these accounts in Atlas.

Google Accounts

If you register with your Google Account, the following differences apply when using your Google account with Atlas:

  • Google manages your user details, email address, and password. You can't change this information using the Atlas console or API.

  • Google manages your 2FA. You can't use Atlas multi-factor authentication and won't be prompted for an Atlas 2FA verification when you log into Atlas. Google should verify your identity using Google 2-Step Verification.

  • If you linked your Atlas account to your Google Account, you can unlink these accounts in Atlas.

MongoDB Cloud Manager Users

If you use MongoDB Cloud Manager, use your Cloud Manager credentials to log in to Atlas. You can then create a new Atlas project from Cloud Manager.

Prerequisites

Add the Atlas CDN Host to your Allow List

Atlas uses a CDN to serve content quickly. If your organization uses a firewall, add the following Atlas CDN host to the firewall's allow list to prevent issues accessing the Atlas UI: https://assets.mongodb-cdn.com/.

GitHub Accounts Require a Public Email Address

If you try to register with Github, you must have an public email address associated with your GitHub account. Atlas returns an error if you attempt to register without a public email address.

To set a public GitHub email address:

  1. After you log into GitHub, click Settings on your profile menu. Your Public Profile page should display.

  2. Select one email address from the Public email dropdown in your Public Profile.

    If GitHub greys out this dropdown menu:

    1. Click Emails from the left-side menu.

    2. Clear the Keep my email addresses private box.

    3. Return to the Public Profile page and select an email address from the Public email dropdown.

  3. Click Update profile to save the changes.

Register a new Atlas Account

Select a tab based on how you would like to register your account:

To register with Atlas using the Atlas CLI, run the following command:

atlas auth register [options]

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

Note

If you run atlas setup with the default selections, you don't need to run atlas auth register.

To register using the Atlas UI, start at the MongoDB Atlas registration page.

  1. Provide the following information about yourself:

    • Email Address

    • First Name

    • Last Name

    • Password

      Note

      Atlas Password Policy

      Your Atlas user account password must:

      • Contain at least eight characters.

      • Exclude your email address and Atlas username.

      • Differ from your previous twenty four passwords.

      • Differ from the most commonly used passwords.

    • (Optional) Company Name

  2. Review the Terms of Service and the Privacy Policy.

  3. Click the checkbox to accept the Terms and Policy.

  4. Verify that you're not a robot.

  5. Click Sign up.

  1. Click GitHub.

  2. Follow the GitHub prompts to sign in.

  3. Review the Terms of Service and the Privacy Policy.

  4. Select the checkbox to accept the Terms of Service and the Privacy Policy.

  5. Click Submit.

  1. Click Google.

  2. Follow the Google prompts to sign in.

  3. Review the Terms of Service and the Privacy Policy.

  4. Select the checkbox to accept the Terms of Service and the Privacy Policy.

  5. Click Submit.

Log in to Your Atlas Account

Select a tab based on how you would like to log in:

To authenticate with Atlas using the Atlas CLI, run the following command:

atlas auth login [options]

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

For step-by-step instructions on logging in using the Atlas CLI, see Connect from the Atlas CLI.

To log in using the Atlas UI:

If you already created a MongoDB account using your email address, sign in to your account:

  1. Navigate to MongoDB Atlas login page.

  2. Enter your email address.

  3. Click Next.

  4. Follow the prompts to log in to your account.

If you already created a MongoDB account using your GitHub account, sign in to your GitHub account:

  1. Navigate to MongoDB Atlas login page.

  2. Click GitHub.

  3. Follow the prompts to log in using your GitHub account.

If you already created a MongoDB account using your Google account, sign in to your Google account:

  1. Navigate to MongoDB Atlas login page.

  2. Click Google.

  3. Follow the prompts to log in using your Google account.

Create an Atlas Organization and Project

Atlas creates an organization and project for you. You can also create them on your own.

At the Organization level, you can implement security controls and create users which work across one or more Projects. To learn more, see The Organization Level.

You can create project-level Atlas users and roles with appropriate access to the different production and development application environments. To learn more, see The Project Level.

Create an Atlas organization and then create a project in this organization. You will deploy your first cluster in this project.

Next Steps

With your Atlas account, open the organization and its project, and then proceed to Deploy a Free Cluster.

See also:

To learn about shortcuts you can use to navigate your new Atlas account, see Quickly Navigate with Atlas Goto.