Skip to content

Device Management

The Devices page is your fleet inventory — a searchable, sortable table of every device connected to Watchgrid.

Device List

The page opens with summary stats and a full data table:

Stats Cards

Four cards at the top show:

  • Total Devices — all registered devices
  • Online — currently connected
  • Offline — not responding
  • K3s Enabled — devices with Kubernetes installed

Search & Filter

  • Search bar — filter by device ID, hostname, location, IP address, or OS
  • Status buttons — toggle between All, Online, or Offline

Data Table

Column Description
Checkbox Select for bulk operations
Status Green dot (online) or red dot (offline)
Device ID Clickable — opens the detail modal
Type Agent, Admin, Service, or Cluster
Hostname System hostname
Location Physical location name
WireGuard IP VPN tunnel address (e.g., 100.64.1.3)
OS Operating system
Version Agent version
K3s "Enabled" badge if K3s is installed
Last Seen Relative timestamp
Actions Terminal button

All columns are sortable (click the header to toggle ascending/descending).

Bulk Operations

Select multiple devices using checkboxes, then use the bulk action bar:

  • Export JSON — download selected devices as a JSON file
  • Delete Selected — remove multiple devices (with confirmation)
  • Clear Selection — deselect all

Use the header checkbox to select/deselect all visible devices.

Device Detail

Click any Device ID to open the detail modal with full information:

Device Information

  • Device ID, hostname, operating system
  • Agent version, WireGuard IP address
  • K3s status (enabled/disabled)

Security & Tenant Binding

  • Tenant lock status — Locked (device is bound to its tenant) or Unlocked
  • Hardware fingerprint — unique device identifier
  • Original tenant ID — the tenant the device was first registered to
  • Unlock Device button — allows tenant reassignment (admin only)

Location

  • Location name, latitude, longitude
  • Editable fields for manual location updates

WireGuard VPN

  • Tunnel IP address
  • Connection status
  • Data transferred (RX/TX bytes)

System Resources

  • CPU usage (percentage + core count)
  • Memory usage (percentage + total)
  • Disk usage (percentage + total)

Tags

Devices can be tagged for organizing your fleet and matching provisioning profiles:

  • View current tags as chips
  • Edit tags inline (comma-separated input)
  • Tags are used for profile matching — a device tagged hackrf will automatically receive profiles that target the hackrf tag

Onboarding New Devices

Click Onboard Device in the page header to open the onboarding modal. This generates a provisioning command you can copy and run on any device. See Provisioning Devices for details.

Terminal Access

Click the Terminal button in the actions column to open an interactive shell session to that device, directly in your browser.