Dashboard

The dashboard is the landing page of Koios — a customizable grid of live widgets for at-a-glance 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 dropdown at the top of the page to switch between dashboards. The dropdown menu also provides options to create a new dashboard, rename the current one, or delete it. When you create a dashboard, you can mark it as the default so it loads automatically on login.

Customize Mode

Click Customize to enter edit mode. 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.

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.

Tag Widgets

Widget	Description
Tag Value	Displays a single tag's live value with an optional ring gauge showing where the value falls within its configured range
Tag Chart	Plots one or more tags over time as a live-updating line chart

Device Widgets

Widget	Description
Device Status	Shows the device's connection state (Running, Stopped, or Failed) with optional error message
Device Uptime	Bar chart showing historical uptime segments
Device Execution	Bar chart of recent scan cycle durations

Model Widgets

Widget	Description
Model Status	Shows the model's inference state with optional error message
Model Uptime	Bar chart showing historical uptime segments
Model Execution	Bar chart of recent inference cycle durations

Each widget type has its own display settings, accessible when adding or editing a widget.

Tag Value

Tab	Settings
Text	Font size (sm / md / lg / xl), font weight, text color (auto or fixed)
Labels	Decimal places override (-1 to 6, or auto from tag config), show units, show tag name
Ring	Show ring gauge, ring color, ring size (60–200 px), ring thickness (1–20 px)

When set to auto, text and ring colors follow the tag's live status — teal for running, red for failed, gray for stopped.

Tag Chart

Tab	Settings
Time	History period: 5 min, 10 min, 30 min, 1 hour, 8 hours, or 24 hours
Line	Line width, line smoothing, point size
Fill	Fill area under lines, fill opacity
Display	Show X-axis, show Y-axis, show legend

Multiple tags can be added to a single chart widget. Each tag gets a unique color automatically.

Status Widgets (Device & Model)

Tab	Settings
Text	Font size, font weight, text color (auto or fixed)
Labels	Show entity name, show error message

Uptime and Execution widgets require only an entity selection — 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.

Migrating to v1.0.0 Protocols