Skip to main content

Inviting users

Installation admins can invite new users to Conveyor, either from the Users tab on the settings page or with the conveyor user create command:

conveyor user create --email jane.doe@example.com

Every invited user receives an invitation email. For users who do not sign in through SSO, it contains a temporary password, which is valid for 7 days. Users who sign in through SSO log in with their identity provider and do not need the temporary password.

caution

Only invite a user once their email address can receive mail, also when they sign in through SSO. Conveyor does not store the temporary password, so you cannot resend the invitation yourself. If the invitation cannot be delivered, for example because the mailbox has not been created yet, it is lost and will not arrive once the mailbox becomes available.

Inviting a user again​

If you're not sure whether the invitation arrived, contact support before deleting the user. Conveyor cannot tell an undelivered invitation apart from an expired one, and deleting and inviting the user again does not help if the email address is blocked.

If the user was created with the conveyor_user Terraform resource, delete and invite them again through Terraform instead of the UI or CLI, to keep the Terraform state in sync.

The temporary password has expired​

If the invitation was delivered but the temporary password has expired, delete the user and invite them again.

warning

Deleting a user also removes all their roles, such as their access to projects, environments, packages and teams. Inviting them again does not restore these.

  1. Note the projects and environments assigned to the user in the Users tab on the settings page, and any packages and teams they belong to.
  2. If the user is an installation admin, remove their admin privileges with the conveyor user remove-as-admin command. Installation admins cannot be deleted.
  3. Delete the user from the Users tab on the settings page or with the conveyor user delete command.
  4. Invite the user again. To make them an installation admin, select As administrator in the invite dialog, or run conveyor user add-as-admin after conveyor user create.
  5. Restore the access you noted in step 1.

The invitation was not delivered​

If the invitation could not be delivered, the email address is blocked from receiving further emails from Conveyor. Contact support to have the email address unblocked and the invitation sent again.