User Management

The Users page allows administrators to manage user accounts, assign roles, and control access to deployments.

Users Overview

The user list displays all accounts in your FlatRun instance:

• Username — User identifier
• Email — Contact email
• Role — Permission level (Admin, Operator, Viewer)
• Status — Active or disabled
• Created — Account creation date
• Last Login — Most recent login time

User Roles

FlatRun provides three built-in roles with different permission levels:

Role Capabilities

Creating Users

1. Click "Add User"
2. Fill in user details:
   • Username — Unique identifier
   • Email — Valid email address
   • Password — Initial password
   • Role — Select permission level
3. Click "Create"

Editing Users

1. Click on a user in the list
2. Click "Edit"
3. Modify details:
   • Email
   • Role
   • Status (active/disabled)
4. Save changes

Changing Username

Usernames cannot be changed after creation. Create a new user if a username change is needed.

Password Management

Reset User Password

1. Select the user
2. Click "Reset Password"
3. Enter a new password or generate one
4. Notify the user of their new password

User Self-Service

Users can change their own password from their profile:

1. Click on username in the header
2. Go to "Profile"
3. Click "Change Password"
4. Enter current and new password

Deployment Access

Control which deployments a user can access (for Operator and Viewer roles).

Assigning Deployments

1. Open the user's detail page
2. Go to "Deployments" tab
3. Click "Assign Deployment"
4. Select deployment(s)
5. Choose access level:
   • Read — View only
   • Write — View and modify
   • Admin — Full control including delete
6. Save

Access Levels

Removing Access

1. Open the user's deployments tab
2. Find the deployment
3. Click the remove icon
4. Confirm removal

Viewing Users by Deployment

See who has access to a specific deployment:

1. Navigate to the deployment
2. Go to Settings → Access
3. View list of users and their access levels

Disabling Users

Disable a user to prevent login without deleting the account:

1. Edit the user
2. Toggle "Status" to disabled
3. Save

Disabled users:

• Cannot log in
• Retain their configuration
• Can be re-enabled later
• API keys are also disabled

Deleting Users

1. Select the user
2. Click "Delete"
3. Confirm deletion

Your Profile

Access your own account settings:

1. Click your username in the header
2. Select "Profile"
3. View/edit:
   • Email address
   • Password
   • Notification preferences
   • API keys

Activity Tracking

View user activity in the Audit Log:

• Login attempts
• Deployment actions
• Configuration changes
• API usage

See Audit Logging for more details.

Best Practices

• Least privilege — Assign the minimum role needed for each user
• Regular audits — Review user access periodically
• Disable unused accounts — Don't leave inactive accounts enabled
• Strong passwords — Enforce password complexity
• Deployment scoping — Only grant access to needed deployments

Keyboard Shortcuts