Skip to content

Users

Overview

The Users section is where you manage the full directory of platform users — creating new accounts, reviewing existing members, and editing user details when needed. Every person who accesses the TRE must have a user account created here first.

Navigation: Select Users from the left-hand navigation pane.

The Users List

When you open Users, the dashboard displays all user accounts currently on the platform:

Screenshot: Users landing page showing the full list of users with columns for Name, Status, Email, Created By, and Created At

Column Description
Name The user's display name or username.
Status The current account state (e.g., Available).
Email The user's registered email address.
Created By The admin account that created this user, if recorded.
Created At The date and time the account was created.

Click the edit icon (pencil) on any row to open and modify that user's details.

Use the search bar at the top of the list to find a user by name or email. Results filter in real time as you type.

Creating a New User

To add a new user to the platform:

  1. Click + Add New in the top-right corner of the Users screen.
  2. Complete the General step of the Create User form, then click Review to confirm.

Step 1: General

Screenshot: Create User form showing Email, Username, Display Name, UID, GID, team selectors, Labels, and Properties fields

Screenshot: Create User form continued

Identity

Field Description Constraints
Email * The user's email address. Used for login and platform notifications. Must be a valid email address. Not editable after creation.
Username * The system-level identifier for this user, used when creating system resources such as the user's home directory. Maximum 32 characters. Must start with a letter and end with an alphanumeric character. Lowercase letters, numbers, hyphens, underscores, and periods only. Not editable after creation.
Display Name The name shown for this user across the platform interface. Maximum 32 characters.

Important: Both Email and Username are permanent — they cannot be changed after the account is created. Confirm both are correct before clicking Review.

System Identity

UID and GID — the user's numeric system user and group IDs. Both default to 1000.

Organisation Hierarchy

Assign the user to the correct position in your organisation's team structure. This determines how the user's activity and resource consumption are attributed across Platform Cost and User Activity.

Field Description
Select team * The top-level team this user belongs to. Required.
Select team2 * The second-level team within the selected top-level team. Required.
Select team3 * The third-level team, the most granular organisational unit. Required.

Labels and Properties

Optional key-value pairs to associate with the user account — useful for filtering, reporting, integration with external systems, or storing custom attributes.

Step 2: Review

Review the user's details before creating the account, paying particular attention to Email and Username — neither can be changed after this point. Click Create to finalise the account. The user appears in the Users list immediately and can be assigned to projects from Projects.

What's Next

  • Projects — assign the new user to one or more projects using the Add Member action on the Projects list.
  • User Activity — monitor what the user does across the platform once their account is active.
  • Platform Audit Logs — all user creation and account changes are captured in the audit log.