Skip to main content
The admin users page at /admin-users gives administrators full visibility and control over every registered account in KilomeTracker.
This page is only accessible to users with the admin or root role. If you navigate to /admin-users without the required role, you are automatically redirected to the dashboard.

Viewing all users

The user list shows every registered account with the following details:
  • Username — the account’s display name
  • Email — the account’s email address
  • Role — one of read, write, admin, or root
  • Status — whether the account is active or deactivated

Role badges

Roles are displayed with color-coded badges to make them easy to identify at a glance:
RoleBadge color
rootRed (destructive)
adminPurple
writeBlue (info)
readGray (muted)

Filtering users

Use the filter controls at the top of the user list to show only active or inactive accounts. Toggle the isActive filter to switch between views.

Role overview

read

Can view vehicles, routes, refuels, maintenance, and expenses. Cannot create, edit, or delete records.

write

Can add and manage vehicles, routes, refuels, maintenance, and expenses. No access to user management.

admin

Full access including the user management panel. Can change roles, deactivate, and reactivate other users.

root

Exists in the database for system-level purposes. Cannot be assigned from the UI. Displayed with a red badge.
The root role cannot be assigned to any user from the admin panel. It exists only at the database level and is not available in the role selector.

Changing a user’s role

1

Find the user

Locate the user in the list. Use the filter or scroll to find the account you want to update.
2

Open the role selector

Click the role badge or the edit action for that user row to open the role selector.
3

Select a new role

Choose one of the available roles: read, write, or admin.
4

Confirm the change

Confirm the selection. The role badge updates immediately in the user list.

Deactivating a user

Deactivating a user performs a soft delete — the account is not permanently removed. Instead, isActive is set to false and the user can no longer log in.
You cannot deactivate your own account. The deactivate action is disabled for the currently logged-in admin.
1

Find the user

Locate the active user you want to deactivate in the user list.
2

Click Deactivate

Click the Deactivate action for that user. A confirmation prompt appears.
3

Confirm

Confirm the action. The user’s status badge changes to inactive and they are immediately unable to log in.

Reactivating a user

Deactivated users remain in the database and can be restored at any time.
1

Filter by inactive

Toggle the filter to show inactive users so the deactivated account is visible in the list.
2

Click Reactivate

Click the Reactivate action next to the user you want to restore.
3

Confirm

Confirm the action. The user’s status changes back to active and they can log in again immediately.

Build docs developers (and LLMs) love