Manage Project Access
On this page
Groups are now projects in the organizations and projects hierarchy.
You can create multiple projects in an organization.
By having multiple projects within an organization, you can:
- Isolate different environments (for instance, development/qa/prod environments) from each other.
- Associate different users or teams with different environments, or give different permissions to users in different environments.
Maintain separate cluster security configurations. For example:
- Create/manage different sets of database user credentials for each project.
- Isolate networks in different VPCs.
- Create different alert settings. For example, configure alerts for Production environments differently than Development environments.
Create a Project
Prerequisites
To create a project for an organization, you must be either an
Organization Owner or an
Organization Project Creator.
When you create a project, you are added as an
Project Owner for the project.
Procedure
To create a project for an organization:
Navigate to the Create a Project page.
- If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
- Click the Leaf icon in the upper left corner of the page.
- Click New Project.
You can also expand the Projects menu in the navigation bar, then click + New Project.
Name your new project.
- Enter the name for your new project.
- Click Next.
Add members.
- For existing Atlas users, enter their username. Usually, this is the email the person used to register.
- For new Atlas users, enter their email address to send an invitation.
Specify the access for the members.
Click Create Project.
Move a Project
When you move a project to another Atlas organization, Atlas copies the project users and their respective roles to the same project in the destination organization. However, Atlas doesn't carryover teams assigned to the project because you define teams at the organization level.
Prerequisites
To move a project to another Atlas organization, you must be an
Organization Owner for both the current and the destination
organization.
Procedure
To move a project for an organization:
View all of your projects.
- If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
- Click the Leaf icon in the upper left corner of the page. You can also expand the Projects menu in the navigation bar, then click View All Projects.
Select the project you want to move.
For the project you want to move:
- Click .
- Click Move Project.
The Move Project dialog appears.
Select the target organization. Click Next: Confirm to go to the confirmation screen.
Click Confirm & Move.
An Organization Owner of two different Organizations
can move projects between those Organizations at any time. Usage in
any particular project during any particular hour is accrued to the
Organization under which the project was at that time.
An Organization Owner owns the Telecomm and
Storage Organizations in Atlas. They decide to move
their Backup project from Telecomm to Storage at
11:40 am.
The Telecomm project is billed for the full 11:00 to 11:59 am hour. Storage starts getting billed at 12:00 pm.
Atlas removes existing API Keys after moving the Project. You must create a new API Key after moving the Project.
Delete a Project
Prerequisites
- To delete a project for an organization, you must either have the
Project Ownerrole for the project or have theOrganization Ownerrole for the project's organization. - The project has no outstanding invoices.
- The project has no active database deployments. Terminate active clusters or serverless instances in the project before you delete it.
- The project has no configured private endpoint connections.
- The project has no active Data Lakes.
Procedure
To delete a project for an organization, you can delete from the organization's Projects view or the project's Project Setting view.
To delete a project from the organization's Projects view:
View all of your projects.
- If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
- Click the Leaf icon in the upper left corner of the page. You can also expand the Projects menu in the navigation bar, then click View All Projects.
For the project you want to delete, click .
Click Delete Project.
If Legacy Two-Factor Authentication is enabled, enter the verification code.
After verifying, click Delete Project again.
To delete from the project's Project Setting view:
Navigate to the Settings page for your project.
- If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
- If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
- Next to the Projects menu, expand the Options menu, then click Project Settings.
In the Delete Project section, click Delete.
Click Delete Project to confirm.
If Legacy Two-Factor Authentication is enabled, enter the verification code.
After verifying, click Delete Project again.