For the complete documentation index, see llms.txt. This page is also available as Markdown.

Users

In user management, you can manage user accounts, set permissions, and add new users.

  1. User Overview

    • Full Name: The full name of the user.

    • Username: The username for logging in.

    • Group: The role of the user, such as "admin" or "user".

    • E-Mail: The user's email address for notifications.

  2. Actions

    • Edit: You can change the details of a user, such as their name, email, or username. This is also where Usage Recording โ†’ "Attribute usage to this person" sits: recording continues either way, this only decides whether recorded actions are linked to this person. Every person can set it themselves in the app as well.

    • Permission: Here, you can set what permissions the user has within the app.

    • Delete: Remove the user from the system.

  3. Add User

    • By clicking "Add User", you can create a new user account. A form will open where you need to enter basic information like name, username, group, and email address.

  4. Setup for new Users

    • This option allows you to create or change templates for new users. This way, you can predefine settings and permissions for newly created accounts.

  5. Group Membership

    • The group membership determines a user's rights in the system. A user in the "admin" group has access to administrative functions, while a "user" has limited rights and can only use certain functions.

  6. Permissions

    The permission settings allow you to individually specify which areas and functions a user can access. The configuration is divided into three tabs:

    Tab: Functions

    Here you define which system functions the user has access to. These include:

    • Node-RED, Rooms, Zones, Devices, Scenes, Schedules, Automations, Cloud, Matter/HAP, Settings, Push Notifications, Remote Access, and Background Image Upload

    Each function can be set to one of the following permission levels:

    Level
    Description

    Full Access

    The user can fully use and control the function.

    Off

    The user has no access to this function. It is not displayed for them.

    Tab: Rooms

    Here you control access to individual rooms. Rooms are displayed grouped by zones (e.g., Ground Floor, Upper Floor). Each room can be assigned an individual permission level:

    Level
    Description

    Full Access

    The user can see and control all devices in the room.

    View Only

    The user can see the devices in the room but cannot control them.

    Off

    The room is not displayed for the user.

    Tab: Scenes

    Here you define which scenes the user has access to. Each scene can be configured individually:

    Level
    Description

    Full Access

    The user can see and execute the scene.

    Off

    The scene is not displayed for the user.

    By combining the three tabs, you can control very granularly which parts of the system a user can see and operate. For example, you can create a user who can only see and control specific rooms, or a user who can view scenes but cannot directly control devices.

Incoming requests

In the Incoming requests tab, administrators can see pending access requests from users who have forgotten their password (see Forgot password).

  • Shown are the username, device, the match code and the remaining validity.

  • Compare the match code with the one shown on the requesting device, then choose Approve or Decline.

  • After approval, the user is logged in on their device with their own permissions.

  • The list refreshes automatically.

An administrator can also approve another administrator's sign-in.

Last updated