Home A - Z
Page Index

Blame

57076d Manuel Weiser 2026-02-23 16:43:14
update
1 
# 11. Admin Area
2
3
**URL:** `http(s)://url/admin`
4
5
![Admin Panel](../images/admin-panel.png)
6
7
> ⚠️ **Note:** The Admin area is only visible and accessible to users with the **Administrator role**.
8
9
The Admin Panel is the central hub for **system administration**. It provides access to the following sections:
10
11
| Card | Description |
12
|------|-------------|
13
| **Users** | User management |
14
| **Roles & Permissions** | Roles and permissions |
15
| **Devices** | Device token management |
16
| **System Extra Fields** | System-wide extra fields for spools and filaments |
17
| **System** | Plugins and system management |
18
19
---
20
21
## 11.1 User Management (Users)
22
23
**URL:** `http(s)://url/admin/users`
24
25
![User Management](../images/admin-users.png)
26
27
Administrators can manage all users in the system here. The table shows:
28
29
| Column | Description |
30
|--------|-------------|
31
| **EMAIL** | User's email address (used for login) |
32
| **DISPLAY NAME** | Display name within the application |
33
| **STATUS** | Active / Inactive |
34
| **ROLES** | Assigned roles (e.g. Superadmin, User) |
35
| **ACTIONS** | Edit / Reset PW |
36
37
Available actions:
38
- **Add User** (top right) – Create a new user with email, password, and role
39
- **Edit** – Change a user's email, name, or role
40
- **Reset PW** – Reset a user's password
41
42
---
43
44
## 11.2 Roles & Permissions
45
46
**URL:** `http(s)://url/admin/roles`
47
48
![Roles & Permissions](../images/admin-roles.png)
49
50
FilaMan ships with three **built-in system roles** that cannot be deleted:
51
52
| Role | Key | Description |
53
|------|-----|-------------|
54
| **Administrator** | `admin` | Full access to all features and the admin area |
55
| **User** | `user` | Standard user with read and write access |
56
| **Viewer** | `viewer` | Read-only access |
57
58
Click **"Create Role"** (top right) to create custom roles with specific permissions. Use **"Edit Permissions"** to fine-tune what each role is allowed to do.
59
60
Click on a role to view and edit its assigned permissions in the **Permissions** panel on the right.
61
62
---
63
64
## 11.3 Devices
65
66
**URL:** `http(s)://url/admin/devices`
67
68
![Device Management](../images/admin-devices.png)
69
70
This section manages **API tokens for devices**. These are required when external devices (e.g. RFID scanners, automated systems) need to communicate with the FilaMan API.
71
72
- **Create token** – Generate a new device token
73
- **Revoke token** – Disable access for a device
74
75
---
76
77
## 11.4 Extra Fields
78
79
**URL:** `http(s)://url/admin/extra-fields`
80
81
![Extra Fields](../images/admin-extra-fields.png)
82
83
**System Extra Fields** allow administrators to define additional data fields for spools and filaments beyond the standard fields. These fields are automatically added to all filaments or spools.
84
85
| Column | Description |
86
|--------|-------------|
87
| **TARGET TYPE** | Whether the field applies to filaments or spools |
88
| **KEY (JSON)** | Internal JSON key for the field |
89
| **DISPLAY LABEL** | Label shown in the user interface |
90
| **DEFAULT VALUE (OPTIONAL)** | Optional default value |
91
92
Click **"Add Field"** (top right) to create a new extra field.
93
94
Examples for extra fields:
95
- "Drying time" for spools
96
- "Print temperature" for filaments
97
- "Supplier" as an additional manufacturer field
98
99
Once extra fields are created, they appear as additional input fields in the corresponding forms (Add Spool, Add Filament).
100
101
---
102
103
## 11.5 System
104
105
**URL:** `http(s)://url/admin/system`
106
107
![System Settings](../images/admin-system.png)
108
109
The System section provides access to:
110
- **Plugin management** – Install and manage extensions
111
- **System settings** – Global configuration options
112
113
---
114
115
## 11.6 Danger Zone
116
117
At the bottom of the Admin Panel you will find the red-highlighted **Danger Zone** with one critical action:
118
119
> ⛔ **"Delete all data"**
120
> Permanently deletes **all** spools, filaments, manufacturers, colors, locations, and printers, including all logs and events.
121
> **User accounts, roles, permissions, and devices are not affected.**
122
> This action **cannot be undone!**
123
124
---
125
126
← [Back: Settings](10-settings.md) | [Next: Color Management →](12-colors.md)