Pulumi Cloud organizations
Organizations are a space for you to collaborate on shared projects and stacks.
Organization Pages
| Page | Description |
|---|---|
| Dashboard | An overview of the organization including recently updated stacks, recent activity, and a resource count graph. |
| All stacks | A searchable list of organization stacks that you can group by project and tag. For more information, see Stacks. |
| Policies | Lists of organization policies and policy groups. Policies allow you to set guardrails to enforce best practices and compliance. |
| Settings | Organization settings including subscription and payment information and history, Billing Managers, stack permissions, and links to Pulumi’s continuous delivery guides. |
Creating an organization
Creating an organization will start a free trial that has access to all features. At the end of the trial, you can choose the Team, Enterprise, or Business Critical edition. Learn more about what each one includes on the pricing page.
To create an organization:
- Select the create organization button at the top of the navigation.
- Provide an organization name, and agree to the terms of service and privacy policy.
- Select Start free trial.
Joining an organization
To become a member of a Pulumi organization, you must be invited by an existing Pulumi organization administrator or submit a request to the administrator for approval. You also need to be a member of the third-party organization or group backing the Pulumi organization. See Identity providers.
For example, to become a member of a Pulumi organization backed by a GitLab Group, you must associate a GitLab identity with your Pulumi account, and also be a member of that GitLab group.
For more information, see How do I link an existing Pulumi account to my company’s organization?
Backing membership doesn’t grant Pulumi membership
Being in the backing GitHub organization, GitLab group, or Bitbucket workspace doesn’t put you in the Pulumi organization. It only makes you someone an admin can add.
Once you connect the matching identity to your Pulumi account, you appear on the list of people a Pulumi organization admin can invite or add. Until an admin does that, you have no access.
If you’re in the GitHub organization but don’t see anything in Pulumi, this is why. Ask an organization admin to add you.
Inviting members to an organization
Pulumi organization administrators can invite new members to an organization.
To invite a new member:
- Navigate to Settings > Members.
- To invite a new member using their email address, select Invite members. After the new member is invited, they will receive an email allowing them to accept the invite.
- To invite a new member by sharing a link, select Copy new invite link. This will copy a link to your clipboard that you can share directly.
New member invitation links never expire and may only be used one time.
Pulumi organization administrators can monitor current organization members and pending invitations on the Members console page. For pending invitations, administrators can re-send email invitations, copy links for both email and link generated invitations, and revoke invitations. The invitation status column in the members table includes the date an invitation was sent, and will note if a potential member encountered an error while attempting to accept an invitation. In this case, a tooltip will share the exact error that was encountered.
Switching between organizations
The organization menu displays your individual organization and all of the organizations you belong to.
To switch to a different organization:
- Select the organization menu at the top of the navigation.
- Select your organization name.
Organization roles
Every member of an organization has a role: the built-in Admin, Member, or Billing Manager, or a custom role. For what each one grants, see Roles. For delegating billing access without admin rights, see Billing Managers.
Updating billing information
Organization admins and Billing Managers can update payment details from the organization’s Billing & usage settings in Pulumi Cloud under Payment methods.
To update billing information:
- Navigate to Settings > Billing & usage.
- Under Payment methods, select Update.
If you need to delegate billing-only access to a team member without granting full admin rights, see Billing Managers.
Changing the company name on invoices
The company name that appears on Pulumi invoices is sourced from your organization’s display name. To change it, update the display name. The updated name will appear on your next invoice, and updates take effect shortly after saving.
To update your organization’s display name:
- Navigate to Settings > General.
- Update the Display Name field and save your changes.
Updating the display name requires the organization:rename permission, which is granted to organization admins.
If you need a legal entity name on invoices that is different from your organization’s product-facing display name, contact support.
Transferring stacks
Stack admins can transfer stacks one at a time between their individual organization and a shared organization, or between shared organizations. Organization admins can transfer stacks in bulk.
Transferring a stack requires two permissions: the right to transfer the stack from its current owner, and the right to create stacks in the destination organization. Both are configured through your organization’s access controls — see Role-based access control for details.
To transfer an individual stack:
- Navigate to the stack and then the stack’s Settings.
- Select Transfer stack.
- Provide the destination organization name and select Transfer.
To transfer stacks in bulk:
- Navigate to the Stacks page.
- Select the three dot menu beside Create project.
- Choose Transfer stacks from the dropdown.
- Choose the Transfer destination from the dropdown.
- Tick the stacks you’d like to transfer (up to 15 at a time) and select Transfer stacks.
Restoring a deleted stack
Restoring a stack recovers a previously deleted stack along with its update history. The 25 most recently deleted stacks in an organization can be restored by an organization admin.
To restore a stack:
- Navigate to the Stacks page.
- Select the three dot menu beside Create project.
- Choose Restore deleted stacks from the dropdown.
- Use the three dot menu on the stack you want to restore and select Restore stack.
Deleting an organization
Organization deletion is a permanent action and can only be performed by an organization admin.
To delete an organization:
- Navigate to Settings.
- Select Delete organization.
Before deleting an organization, make sure you have transferred any stacks you want to keep to another organization.
For more information, see How can I delete a Pulumi organization?
Organization identity providers
Every Pulumi organization is backed by an identity provider that governs who can be a member: Pulumi itself, a GitHub organization, a GitLab group, a Bitbucket workspace, or a SAML 2.0 identity provider.
See Identity providers for the full list of options, how to set each one up, and how to change your organization’s provider.