Dashboard
The dashboard is the landing page of Koios: a customizable grid of live widgets for monitoring. You can create multiple dashboards, each with its own set of widgets tailored to a specific process, area, or role.
Managing Dashboards
Use the dashboard selector at the top of the page to switch between dashboards. The adjacent three-dots menu provides options to create a new dashboard, rename the current one, or delete it. To make a dashboard load automatically on login, click the star icon next to it in the selector dropdown. A filled yellow star marks your favorite.
Customize Mode
Click the pencil icon beside the dashboard selector to enter edit mode. On an empty dashboard, the Start Customizing button does the same thing. In this mode:
- Widgets show drag handles and resize grips
- You can drag widgets to reposition them on the grid
- You can resize widgets by dragging the bottom-right corner
- Edit, duplicate, and delete icons appear on each widget
- The Add Widget button becomes available
Layout changes are saved automatically. Click Done to exit edit mode.
Adding a Widget
In customize mode, click Add Widget to open the widget configuration modal:
- Choose a widget type from the grouped dropdown (Tags, Devices, or Models)
- Select the entity: the tag, device, or model the widget will display
- Set a title (optional, defaults to the widget type name)
- Configure display settings using the tabs (varies by widget type)
The widget is placed at the first available position on the grid. You can drag it to a different spot after adding.
Widget Types
Tag Widgets
Device Widgets
Model Widgets
Widget Configuration
Each widget type has its own display settings, accessible when adding or editing a widget.
Tag Value
When set to auto, text and ring colors follow the tag's live status: teal for running, red for failed, gray for stopped.
When a failed tag's reading is out of date, because its own read failed or its device has failed, the widget shows the reading it last took, dimmed, with how long ago it was taken, and leaves the ring empty.
Tag Chart
Multiple tags can be added to a single chart widget. Each tag gets a unique color automatically.
Status Widgets (Device & Model)
Uptime and Execution widgets require only an entity selection, with no additional display settings.
Editing & Duplicating Widgets
In customize mode, click the gear icon on a widget to edit its title, entity, or display settings. Click the copy icon to duplicate a widget with all its settings. The duplicate is automatically placed at the next available position.
Grid Layout
The dashboard uses a 12-column responsive grid. Widgets snap to grid cells and cannot overlap. On smaller screens the grid reduces to fewer columns (6 on tablets, 4 on large phones, 2 on small phones) and widgets reflow accordingly.
Permissions
Creating, renaming, deleting, and customizing dashboards all require the Manage dashboards permission. Without it the controls stay visible but are disabled, with a tooltip explaining why. Viewing dashboards and their live widgets needs no extra permission. See Roles & Permissions.