mLab Account Setup

Overview

To get started with mLab, create your free mLab account. Your mLab account allows you to create an unlimited number of MongoDB deployments and to manage those subscriptions, you’ll want to make sure that you’ve adjusted your account settings to control who has access to your account and to specify your contact and billing preferences.

Managing your mLab account

In this section, we discuss everything you need to know about account users, admin privileges, and how to update settings such as your contact preferences and billing information.

Account Users

When you first sign up for a mLab account, you are prompted for an account name and a unique username and password for the initial account user. mLab account users are allowed to access the mLab management portal and manage the account’s settings and database deployments. Each account user should have a unique username and a password which are used to log in to the mLab management portal.

By default, the initial mLab account user (created when the account is first created) is designated as the Admin User. There can be only one Admin User per mLab account. The Admin User is the only one who can:

Add a new account user (admin-only):

  1. Log in to the mLab management portal
  2. Click “Account” in the upper right-hand corner to open the Account Settings page
  3. If the “Users” tab is not already highlighted, click it to show the list of Account Users
  4. Click the “Add account user” button
  5. Fill in the new account user’s information (a unique username, email, and password)
  6. Click the “Add” button to add the new user

The same email address can be associated with multiple account users in multiple accounts.

Re-assign admin privileges (admin-only):

  1. Click the row with the user that you’d like to pass admin rights to
  2. Click the “Change to admin” button on the User Details page
  3. Click “Yes” to confirm the new user should be assigned admin rights

Once you re-assign admin rights to another user, you will immediately lose your admin privileges.

Update account user information (e.g., username, password, email):

An account user (does not have to be the Admin User) can update his/her own user information following these steps:

  1. Log in to the mLab management portal
  2. Click “Account” in the upper right-hand corner to open the Account Settings page
  3. If the “Users” tab is not already highlighted, click it to show the list of Account Users
  4. Click the row with your username (or if you have admin rights, click the row of the user you want to update)
  5. Make your desired changes
  6. Click “Modify” to save the changes

Set up two-factor authentication for your account user

Each account user has the ability to activate two-factor authentication so that in addition to entering a password when logging in, they must also provide an authentication code. To read more about how it works and how to set it up, see Two-Factor Authentication.

Delete an account user:

If you are an account user, you can delete yourself as long as you are not the Admin User. Additionally, the Admin User has the ability to delete an account user.

  1. Click the delete icon (a blue “X”) that appears at the end of the row for the user to be removed
  2. Click “Delete” to confirm that the account user should be permanently deleted

Once you delete yourself as an account user, you will immediately lose access to the mLab management portal and your mLab account.

It’s easy to mix up “account users” with “database users” but it’s important to know that these types of users are not the same. Database user credentials cannot be used to log in to the mLab management portal. Conversely, you cannot use account user credentials to authenticate against a MongoDB database. Read more about database users here.

Account Contacts

Official communication, including notifications about incidents which have impacted or may impact database availability will always be sent out to the appropriate Account Contacts as defined below. It’s also possible that all mLab users in your account will be contacted if the situation is critical enough to warrant it.

There are four possible Account Contacts which can be registered with your mLab account:

Admin User

By default, all communication related to your mLab account will be directed to the email address of the account user designated as admin.

Technical Contact

For technical messages, if you’d like us to use an email address that is different from the Admin User’s email, update the “Technical contact email” field.

Only the Admin User can update this field.

Emergency Contact

The “Emergency email” value, if provided, will be used in the event of an emergency. This field is also useful for emergency alerting through services such as PagerDuty which will allow you to set up alerting via email/phone/sms and define escalation policies for your organization.

Only the Admin User can update this field.

Billing Contact

Invoices, payment receipts, and other billing-related notifications can also be sent to an email that is different from the Admin User’s email. If you’d like to use a different email address for billing-related notifications, provide it in the “Billing email” field on the “Billing” tab (detailed instructions can be found in the Billing section below).

The Billing Contact can be updated by any account user, not just the Admin User.

Billing

Our automated credit card billing system offers a secure, hassle-free payment process for customers who choose a for-pay plan or want to use our Backup services.

Your credit card is automatically charged at the beginning of each month for services provided in the prior month. See our Database Subscriptions documentation for more information about how we calculate services charges.

Add a new credit card

  1. Log in to the mLab management portal
  2. Click “Account” in the upper-right hand corner to open the Account Settings page
  3. Click the “Billing” tab
  4. Click the “Add card” button and fill in the required information
  5. Click “Add” to save the credit card information

More than one credit card can be added to your account - just click the “Add card” button again to add more.

Change the default credit card

The first credit card you enter will be automatically set as the default card to be used for account charges. If you have more than one card, you can change the default by clicking the blue star icon that appears at the end of the row of the card you wish to designate as default. You will know which credit card is marked as the default because it will be the first card listed and have an asterisk in the “Default?” column.

In the event you have more than one credit card associated with your account and we run into a problem with your default credit card (e.g., a monthly payment cannot be paid), you will be notified of the issue. If we do not hear back from you, we may attempt to charge other credit cards on your account even if they are not marked as the default.

Remove a credit card

To remove a credit card, click the blue X icon that appears at the end of the row of the card you want to delete.

Update an existing credit card

To update the information for a specific card, first delete the original credit card and re-add the card again as a new card. If there is more than one credit card in your list, make sure you have the correct one selected as the default.

Change billing contact and invoice information

If you’d like to use a different email address for billing-related notifications and invoices, specify the email address on the “Billing” tab. You can also specify additional information to appear on your monthly invoice (e.g., VAT ID, company address, etc.).

To update the billing contact and/or organizational information, follow these instructions:

  1. Log in to the mLab management portal
  2. Click “Account” in the upper-right hand corner to open the Account Settings page
  3. Click the “Billing” tab
  4. Update the email address in the “Billing email” field
  5. Update organization information in the “Organization Info” section
  6. Click “Save changes” to save your changes

Changing your account name

Your mLab account’s name (not the username for an account user) can be changed if requested by the Admin User. To change the name of your mLab account, contact support@mlab.com.

Closing your account

We understand if you no longer require our services. We’ve tried to make the process as simple as possible to delete your account.

Steps to delete your account and permanently delete all of its associated data:

  1. If you would like to keep a copy of your data, export it before you delete your account
  2. Log in to the mLab management portal
  3. Click “Account” in the upper right-hand corner to open the Account Settings page
  4. Click the “Delete account” button in the upper-right hand corner
  5. If there is no balance associated with your account, your account will be deleted immediately.

If you have any outstanding charges at the time you delete your account, you will receive your final invoice within a week and your account will be deleted immediately after the invoice is sent. If you do not receive your invoice within a week or if you’d like us to rush it to you sooner, please contact support@mlab.com.

Have feedback?

We’re always looking for ways to improve our service - send us your feedback at support@mlab.com. We appreciate the comments and suggestions from our users - thank you!