Skip to content

Dashboard Reference

The Dashboard is the home screen of ntkDeploy. It provides a real-time snapshot of your fleet configuration data and one-click access to the most common actions.

Prerequisites

Layout

The Dashboard is divided into four areas rendered top-to-bottom:

Area Location Purpose
Quick Actions Top One-click entry points for common tasks
Statistics Below Quick Actions Fleet-wide entity counts
Recent Activity Bottom-left (2/3 width) Last 10 audit log events
Warnings Bottom-right (1/3 width) Dynamic issues requiring attention (enrollment queue, etc.)

Quick Actions Card

Four buttons are always visible at the top of the Dashboard:

Button Shortcut Action
Create Profile Ctrl+N (when Profiles is active) Opens the new-profile wizard
Import Profile — Navigates to the Profiles section; import dialog is pending implementation
Create Device Group — Navigates to the Device Groups section
New Deployment — Navigates to the Deployment section

Tip: Pressing Ctrl+N anywhere in ntkDeploy triggers a context-sensitive "new" action. On the Dashboard it is linked to the Create Profile flow.

Statistics Card

The Statistics card shows live counts loaded from the local SQLite database in parallel when the Dashboard opens.

Metric What it counts
Total Profiles All profiles stored in the local database
Total Device Groups All device groups in the local database
Total Devices Sum of all UNC destination paths across every device group
Recent Deployments Successful rollouts (rollout_succeeded) recorded in the audit log
Total Providers Registered cloud provider instances
People Policy people records (displayed only when Policy Manager is configured)
Attributes ABAC attribute definitions (displayed only when Policy Manager is configured)

Statistics are fetched in parallel at page load. To refresh, navigate away and return to the Dashboard.

Recent Activity Card

Shows the 10 most recent audit log entries across all entity types.

Row Layout

Element Description
Icon (leading) Color-coded action type indicator
Title Action label and entity type concatenated (e.g., Profile Created profile)
Subtitle Date and time in MMM d, HH:mm format (e.g., Mar 3, 14:30)
Trailing Actor — user or system that triggered the event

Event Type Colors

Icon colors indicate the nature of each event at a glance:

Action type Icon color meaning
profile_created Primary accent color
profile_updated Tertiary accent color
assignment_created Secondary accent color
rollout_succeeded Primary accent color
rollout_failed Error color (red)
policy_capabilities_check Tertiary accent color
All other events Muted surface color

Theme-dependent: The exact hue for each color role is determined by the active app theme and its light/dark variant. Exact colors may differ between Light and Dark mode.

Note: The full Audit Log page uses a separate mapping with fixed colors; its icon hues differ from the Dashboard card. See Audit Log Reference for details.

For the full list of recorded event types and filtering options, see Audit Log Reference.

Warnings Card

The Warnings card is titled Warnings & Issues. It surfaces actionable conditions that require operator attention.

Enrollment warning

When one or more devices are waiting for enrollment approval, the card displays an enrollment warning row:

Element Description
Icon Warning triangle
Message "N devices awaiting enrollment approval" — where N is the live count of pending requests
Action The warning row is clickable and opens the Policy section so you can continue to People → Enrollment Queue

The pending count is loaded from the Policy Manager when the Dashboard opens, in parallel with the other Statistics. It reflects the snapshot at load time.

Fallback state

When the pending enrollment count is zero, or when the Policy Manager is unreachable, the card displays a green checkmark with the label No warnings. A null count (Policy Manager connection unavailable) is treated identically to zero — no warning row is shown.

Note: The enrollment count does not auto-refresh. Navigate away from and back to the Dashboard to reload it.

Error State

If the Dashboard fails to load (e.g., a database initialisation error), an error icon and message are shown in place of the statistics. Restart ntkDeploy; if the error persists, see Common Issues.

Next Steps