Users

A user is defined as any individual who can log in to Mugnsoft. Each user is associated with a role that includes permissions. Permissions determine the tasks a user can perform in the system. For example, the Admin role includes permissions for an administrator to create and delete users.

Mugnsoft has built-in users, a communication user, a default admin and user.

To access the users page

User Role

The user role defines the actions (add/view/delete), a user can perform on a given monitor/report/downtime.

Admin Role

Can do everything.

User Role

Can create and modify monitors, reports and downtimes. These actions are limited to the monitors he is allowed to access. Cannot change settings, create or edit new users.

Viewer Role

Can only view monitors, reports and downtimes. These actions are limited to the monitors he is allowed to access. Cannot change settings, create or edit new users.

Account type

Independently of the group, each user has an account type: full or limited. While the group defines which actions are allowed (view/edit/delete), the account type defines how much the user can extend the platform on his own:

Account type	Behavior
`full`	Can create new tags on the fly (the tag selector accepts new values), and can create reports and downtimes even without the admin group.
`limited`	Can only pick from existing tags. The add report and add downtime buttons are hidden unless the user belongs to the `admin` group.

Use limited for consumers of the platform (dashboards, reports readers) and full for team members who actively manage their own monitors, reports and downtimes.

SSO (OIDC) users get their group and account type re-applied at every login from the role mapping — see SSO / OIDC.

Access perimeter: tags and apps

Two fields on the user profile define what data the user can see:

Tags — tags are associated with monitors and determine the monitors a user can access. Admin users have the ability to add or remove tags from a user’s profile. A user profile can have one or more tags, which can be added or edited by simply modifying the user profile.
Apps — application names. A user with apps assigned sees those applications and their monitors on the application dashboards (/app, 3D plane) in addition to what his tags grant.

The effective perimeter is the union of tags and apps. A non-admin user with no tags and no apps sees no data at all — the UI shows “You don’t have access to these data. Please contact your admin”. Users in the admin group always see everything, regardless of tags/apps.

Profile display preferences

Each user profile also carries personal display preferences. Admins can preset the 3D plane view defaults when adding or editing a user; every user can adjust his own preferences at any time by clicking his avatar (top-right corner) to open his profile.

3D plane view

Layout defaults for the immersive 3D dashboard (apps 3D plane):

Parameter	Description
Max Apps/Row	How many application tiles per row on the 3D plane (default `6`).
H-Spacing	Horizontal spacing between tiles (default `5`).
V-Spacing	Vertical spacing between rows (default `15`).
Alerts banner	Scrolling ticker of non-OK items along the top of the 3D dashboard: `None`, `App banner` (apps only) or `App + Monitor`.
Dark mode	Dark background theme for the 3D dashboard.
Background image	Custom PNG/JPG image shown behind the 3D dashboard, with a display scale (10–500%).
Auto-scale to fit	Sizes the background image to the applications rectangle in the 3D view. While it is on, the manual Scale value is ignored.

The three grid-spacing fields are ignored while a saved drag-and-drop 3D layout exists for the user (a note with a Clear saved layout button appears in the profile in that case). Clear the saved layout to fall back to the grid parameters.

List view

Default layout of the Applications (/app) and All monitors (/all) list pages. These preferences are personal — each user sets them from his own profile (avatar → profile).

Default view is a single choice, not a set of independent toggles: the page always opens in exactly one of these modes. The chooser is the same segmented control that sits in the page toolbar, so what you pick here is simply the mode the page starts in.

Default view	`/app`	`/all`	Description
Compact	✔	✔	Densest grid — smallest cards, most items on screen.
Standard	✔	✔	Standard cards (default).
Detailed	✔	—	More information per card.
Weather	✔	—	Simple, non-technical status view: one weather icon per application (sun = healthy, thunderstorm = outage, …) — detailed below.
Table	✔	✔	Sortable, paginated datatable instead of cards.

Parameter	Description
Sort by	Default sort order: `Health` (worst first) or `Name` (alphabetical). Configurable separately for `/app` and `/all`.

The default view is a starting point, not a lock. Switching view or sort from the page toolbar applies immediately for the session; the page still opens in the profile default next time. Changing the toolbar sort is remembered, so the two stay in sync.

Weather view (`/app`)

The weather view replaces the technical application cards with one status tile per application, designed for wall displays and non-technical viewers:

A “Needs attention” summary bar counts applications per status, worst first. Clicking a count filters the grid to that status; clicking it again clears.
The ? button opens the status legend (healthy / warning / degraded / outage / emergency / maintenance / unknown).
The toolbar search box and the sort chip (by name / by health) apply to this view as well, so the same filtering habits carry over from the card views.
Clicking a tile opens that application’s report.

Edit a User

click on the pencil icon

To add more tags, simply edit the user: admin users can add or remove tags from a user profile. A user profile can have one or more tags.

A. Go to the Settings panel

Set here the username, fullname, state (enabled/disabled), his email and his user group. The user group defines what actions this user can perform on the monitors he has access to: edit/view/delete
To change that user password, click to toggle the password change fields
Add or remove tags from this user profile

B. Click on update

The new tag should be visible in the user list.

In the above screenshot, we can see:

A enabled user (green line at the top of the user’s profile tile)
A disabled user (red line at the top of the user’s profile tile)

Add a User

click on the plus icon

Tags are tied to monitors, they define which monitors the user is allowed to access. To add more tags, simply edit the user: admin users can add or remove tags from a user profile. A user profile can have one or more tags.

A. Go to the Settings panel

Set the username, fullname, state (enabled/disabled), his email and his user group. The user group defines what actions this user can perform on the monitors he has access to: edit/view/delete, a password.
Add or remove tags from this user profile

B. Click on save

The new user appears in the list

Duplicate a User

To duplicate a user, simply edit the user you want to duplicate, change his username, then click on Duplicate/save, the duplicated user should appear in the listing.

click on the plus icon

A. Go to the Settings panel

Set the username, fullname, state (enabled/disabled), his email and his user group. The user group defines what actions this user can perform on the monitors he has access to: edit/view/delete, a password.

B. Click on duplicate