VM User Management

Latest Frontend Version: 2.17.3

Add Users to a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add users to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, click the Add users button in the top-right panel.
7. In the pop-up, enter the user names to add, their profile, and their role in the VM.
8. For custom users, tick or untick permissions in the VM.
9. Click Add users.

Confirmations, Errors & Solutions

Failed to View Users Section in Virtual Machine

Failed to list users: insufficient permissions: users:list: missing permission: {PermUsers}.

Ask VM Users Permissions from VM Owner

Ask the VM owner to allow you to access the VM users section.

To Virtual Machine Owner
To allow VM users permissions to a VM user:  

1. In the VMs section, click the virtual machine where you want to update a user's viewing users permissions.
2. Click the VM Settings and Details option in the bottom center.
3. In the new window, select the Users section in the left panel.
4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
5. Select Edit user access.
6. In the pop-up, set the profile to Custom.
7. Scroll down under Permissions, and tick Users View other users.
8. Click Save.

Did Not Select Users, Teams and/or Groups

You must select at least one user from the autocomplete.

Select Users, Teams and/or Groups

In the Add Users to vm-name prompt, select existing users, teams and/or groups in the Add Users,Teams, Groups field.

Add Teams to a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add teams to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, click the Add users button in the top-right panel.
7. In the pop-up, enter the team names to add, their profile, and their role in the VM.
8. For custom teams, tick or untick permissions in the VM.
9. Click Add users.

note

• This adds all team members of the selected team(s) to the virtual machine.
• You may only add one team per virtual machine.

Add Groups to a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add groups to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, click the Add users button in the top-right panel.
7. In the pop-up, enter the group names to add, their profile, and their role in the VM.
8. For custom groups, tick or untick permissions in the VM.
9. Click Add users.

note

This adds all group members of the selected group(s) to the virtual machine.

tip

You can add a combination of users, teams and groups to the VM simultaneously.

Confirmations, Errors & Solutions

Failed to View Groups Section in Virtual Machine

Failed to list groups: insufficient permissions: group:list: missing permission: {PermGroups}.

Failed to List Groups in Virtual Machine

Failed to list groups: insufficient permissions: group:list: insufficient role, need RoleManager.

Ask VM Groups Permissions from VM Owner

Ask the VM owner to allow you to access the VM groups section.

To Virtual Machine Owner
To allow group permissions to a VM user:  

1. In the VMs section, click the virtual machine where you want to update a user's group permissions.
2. Click the VM Settings and Details option in the bottom center.
3. In the new window, select the Users section in the left panel.
4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
5. Select Edit user access.
6. In the pop-up, set the role to Manager.
7. Scroll down under Permissions, and tick Groups View groups.
8. Click Save.

Add Users, Teams and Projects as Managers to a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add managers to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, click the Add users button in the top-right panel.
7. In the pop-up, enter the user, team and project names to add and their profiles.
8. Set their role to Manager.
9. For custom users, teams and projects tick or untick permissions in the VM.
10. Click Add users.

note

• Adding a team or project as manager adds all users within the team or project as managers in the VM.
• You cannot add managers to a VM you do not own but that was shared with you. You must own or co-own the VM to add other managers.

Confirmations, Errors & Solutions

Added Users, Teams and Projects Successfully

Add total-users-total-team-members-or-total-project-members-addedtotal-adding-time.

Add Users, Teams and Projects as Co-Owners to a Virtual Machine

bulk-action

Method One

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add co-owners to.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, click the Add users button in the top-right panel.
7. In the pop-up, enter the user, team and project names to add and their profiles.
8. Set their role to Co-owner.
9. For custom users, teams and projects tick or untick permissions in the VM.
10. Click Add users.

Method Two

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the Virtual Machines Table Overview section on the top left panel.
3. In the left panel, click the Open Full Menu button by the virtual machine to add co-owners to.
4. Select Add co-owners.
5. In the pop-up, enter the user names to add as co-owners to the virtual machine.
6. Select whether or not to sync user access.
7. Click Update.

tip

Use sync user access for transparency between co-owner roles.

note

• You cannot add co-owners to a VM you do not own but that was shared with you. You must own or co-own the VM to add other co-owners.
• You may need to enter your password to perform this operation.

caution

Adding co-owner(s) also grants them access to the VM's associated drives. Co-owners can restart and mount these drives in other VMs.

Confirmations, Errors & Solutions

Updated Users' to VM Co-owners Successfully

Updated user(s).

Updated Users' to VM Co-owners Successfully

Sync user access for vm-name VM total-syncing-time.

Added Users, Teams and Projects Successfully

Add user-name to vm-nametotal-adding-time.

Failed to Select the Co-Owner

You must select at least one user from the autocomplete.

Select User to Be the VM Co-Owner

In the Add users, teams, groups field, ensure you select the user for the co-owner position in the VM.

Remove Users from a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to remove users from.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, select the user to remove.
7. Click the Open Full Menu button in the top right panel.
8. Then, select Remove user access.
9. In the pop-up, click Delete user to proceed.

info

Removed VM users lose access to the VM, but their home directory and group membership remain unchanged.

note

You cannot remove yourself from a VM if you are the sole owner.

Confirmations, Errors & Solutions

Removed Users from VM Successfully

Remove user-name(s) from vm-nametotal-removing-time.

Failed to View Users Section in Virtual Machine

Failed to list users: insufficient permissions: users:list: missing permission: {PermUsers}.

Ask VM Users Permissions from VM Owner

Ask the VM owner to allow you to access the VM users section.

To Virtual Machine Owner
To allow VM users permissions to a VM user:  

1. In the VMs section, click the virtual machine where you want to update a user's viewing users permissions.
2. Click the VM Settings and Details option in the bottom center.
3. In the new window, select the Users section in the left panel.
4. Next, select the appropriate user, then click the Open full menu button in the top-right panel.
5. Select Edit user access.
6. In the pop-up, set the profile to Custom.
7. Scroll down under Permissions, and tick Users View other users.
8. Click Save.

Edit Roles in a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to edit management roles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, select the user(s) to manage.
7. Click the Open Full Menu button in the top right panel.
8. Then, select Edit user access.
9. In the prompt, select the user(s) role between User and Manager.
10. Click Save.

Confirmations, Errors & Solutions

Updated Users' Roles VM Successfully

Updated user.

Edit Permissions in a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to manage user permissions.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, select the user(s) to manage.
7. Click the Open Full Menu button in the top right panel.
8. Then, select Edit user access.
9. In the pop-up, tick or untick VM user(s) permissions.
10. Click Save.

Confirmations, Errors & Solutions

Updated Users' Permissions VM Successfully

Updated user.

Access User Profiles in a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to access user profiles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Profiles section in the left panel.

note

All VM users can access profiles within their virtual machines. However, restrictions may apply to which users can apply the profiles.

Add User Profiles in a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to add user profiles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Profiles section in the left panel.
6. Click the Add new profile button in the top right panel.
7. In the pop-up, enter the profile name.
8. Select the role and permissions.
9. Click Create Profile.

Confirmations, Errors & Solutions

Failed to Enter User Profile Name

Did not enter user profile name in Add User Profiles to vm-name prompt.

Enter User Profile Name

Enter the user profile name in the Profile Name field.

Failed to Select User Profile Role

Must select a role.

Select User Profile Role

Select a user profile role under the Role section.

Import User Profiles from the Same or Other Virtual Machines

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to import user profiles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Profiles section in the left panel.
6. Click the Add new profile button in the top right panel.
7. In the pop-up, tick Import profile from the same or other VM.
8. Next, select the existing profile and enter a new profile name.
9. Alter permissions for the new profile.
10. Click Create Profile.

Apply Virtual Machine User Profile to User(s)

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to edit management roles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Users section in the left panel.
6. Next, select the user(s) to manage.
7. Click the Open Full Menu button in the top right panel.
8. Then, select Edit user access.
9. In the prompt, select the user(s) VM profile at the top.
10. Click Save.

Confirmations, Errors & Solutions

Applied Users' Profile VM Successfully

Updated user.

Edit User Profiles in a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to edit user profiles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Profiles section in the left panel.
6. Click the Edit permissions button in the top right panel.
7. Next, tick or untick permissions of the VM user profiles.
8. Finally, click Save in the top right corner.

note

• You can edit multiple VM profiles in bulk at the same time.
• To edit a single profile, use the Edit button next to the user profile.

Confirmations, Errors & Solutions

Failed to Enter User Profile Name

Updated total-number-of-user-profiles to vm-name (total-updating-time).

Delete User Profiles in a Virtual Machine

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the virtual machine to edit user profiles.
4. Click the VM Settings and Details option in the bottom center.
5. In the new window, select the Profiles section in the left panel.
6. Click the Remove button next to the user profile you want to delete.
7. In the pop-up, click Remove to proceed.

Bulk Email Users from a Virtual Machine

bulk-action

1. Go to the Virtual Machines icon in the top left taskbar.
2. Click the VMs section on the top left panel.
3. In the left panel, click the Open Full Menu button by the virtual machine to bulk email.
4. Select Bulk Email.
5. In the pop-up, click Copy to copy the VM users' emails or click Download to download them.
6. Once done, click Close.

note

Tick the Prefer contact email? checkbox to use the email registered upon user account creation.