Organizations
Within Deep Origin, we recommend that teams use organizations to collaborate. An organization is a group of one or more users who can share databases, storage drives, variables and secrets, billing, and more.
In addition, organizations are the functional units responsible for billing within Deep Origin. More information about billing is available here.
One account, multiple organizations
Your Deep Origin user account represents you, and your account can be a member of multiple organizations. For example, an academic scientist could collaborate with multiple labs using a single account. This scientist could be the owner of one organization for their lab and a member of the three others for collaborating labs.
Importantly, each resource within Deep Origin, such as a workstation or storage drive, is owned by a specific organization. This organization determines the users that each resource can be shared with, and the organization which will be charged for the resource.
Your first organization
If you create an account following an invitation to join an organization from a colleague, your account will be added to their organization. If you create an account organically, when you create your account, you will be asked to create an organization and choose an ID and name for your organization.
Your active organization in the Deep Origin web application
When you sign into the Deep Origin web application for the first time, your first organization will automatically be set as the active organization. When you sign into the Deep Origin web application again, the last organization that you utilized will automatically be set as the active organization.
To help you work efficiently, the left navigation menu in the Deep Origin web application will direct you to the resources for your active organization. For example, clicking the "Data" item in the left navigation menu will direct you to the data for your active organization.
You can change your active organization by clicking the "Organizations" item in the left navigation menu, clicking its actions menu, and selecting the "Activate" option.
In addition, you can view the resources for your other organizations by clicking the "Organizations" item in the left navigation menu, opening the organization you wish to explore, and navigating to its resources tab.
Managing organizations
To see the organizations you belong to or to create a new organization, click the "Organizations" item in the left navigation menu. From this page, you can view the organizations you belong to and add new organizations.
Creating a new organization
To create a new organization, first click the "Organizations" item in the left navigation menu. Second, click the "Create" button. Third, enter the following information:
- Name: Enter a human-readable name for your organization. This name will shown throughout the Deep Origin UI to help you identify the organization. This name can be changed after the organization has been created.
- ID: Enter an identifier for your organization. This ID must be globally unique within Deep Origin, and it cannot be changed after the organization has been created.
When you create an organization, you will be automatically given the owner role for the organization.
Managing members
Users with the role owner or administrator of an organization can invite members, change the roles of the existing members, and delete existing members. Only users with the owner role can grant other uses the owner role. Information about the permissions of each role is here.
After you've created an organization, you can add, edit, and remove its members.
To manage the members of an organization, first click the "Organizations" item in the left navigation menu and then select the organization that you wish to manage. Second, use the on-screen buttons to add members, edit the roles of the existing members, and remove members.
Adding new members
To add a new member to your organization, first click the "Add member" button. Second, enter the email for the user, assign them at least one role, and click the "Invite" button. If an account already exists with this email, the user will be invited to join your organization. If an account does not exist for this email, the user will be invited to create a new account and join your organization. Once the user has created an account, the account will be added to your organization.
Editing the role(s) of a member
To edit the role(s) of a member, click the "Members" tab, navigate to the member, click its actions menu, select the "Edit" option, add or remove roles in the modal window that appears, and click the "Update" button.
Removing a member
You cannot remove other users with the owner role. To remove another user with the owner role, the other user must first remove their owner role from the organization. Once the other user has removed their owner role, you will be able to remove the other user from the organization.
Each organization must have at least one user with the role owner. Once an organization only has a single user with the owner role, that user will not be able to remove their owner role from the organization.
To remove a member from an organization, navigate to its "Members" tab, navigate to the member, click its actions menu, select the "Delete" option, and confirm their removal in the modal window that pops up.
Deleting an organization
Only users with the owner role can delete an organization.
Deleting an organization will stop and terminate all data, workstations, storage drives, variables, secrets, and other resources owned by the organization. This action is irreversible. All files contained within the databases, workstations and storage drives owned by the organization will permanently be lost.
To delete an organization, click the "Organizations" item in the left navigation menu, select the organization you wish to delete, click its actions menu, select its "Delete" option, and confirm the action in the popup window.