Skip to main content
The Devices page lists every device enrolled in your organization and gives you controls to manage their lifecycle.

​
Device List

Each row in the device list shows:
  • Device name — the hostname reported by the agent at enrollment
  • Status — Active or Disabled
  • Enrolled at — when the device was first registered
  • Last seen — most recent telemetry timestamp

​
Enrolling a Device

1

Open the enrollment dialog

Click Enroll Device in the top-right corner of the Devices page.
2

Get an enrollment code

Choose one of two options:
  • Copy code — copy the one-time code to paste into the agent CLI yourself
  • Send via email — enter an email address and Charley will send the code with installation instructions
3

Run the agent enrollment command

On the target machine, run:
charley enroll --code <CODE>
The device registers immediately and appears in the list with Active status.
Enrollment codes are one-time use and expire after 24 hours. If the code expires before use, generate a new one.

​
Device Status

​
Active

The device is enrolled and the agent is reporting telemetry. Analytics from this device are included in the Overview.

​
Disabled

The device is enrolled but the agent’s data is excluded from analytics and the device cannot enroll new sessions. Use this to temporarily suspend a device without losing its history.

​
Actions

Right-click a device (or use the action menu) to access:
ActionDescription
DisableSuspends the device. Telemetry stops being counted.
EnableRe-activates a previously disabled device.
DeletePermanently removes the device and all associated telemetry. This cannot be undone.
Deleting a device does not uninstall Agent Charley from the endpoint. You’ll need to uninstall the agent separately on the machine itself.

​
MDM Enrollment Key (Enterprise)

Enterprise plans support a persistent enrollment key for deploying Agent Charley through an MDM (Mosyle, Jamf, Munki, Intune, etc.). Unlike one-time codes, the enrollment key never expires and supports unlimited uses, making it suitable for automated fleet deployment. Find the enrollment key under Devices → Enrollment Key (or Settings → Enrollment Key). From there you can:
  • Generate a new key (shown once — copy it immediately)
  • Rotate the key (invalidates the old one; already-enrolled devices are not affected)
  • Revoke the key (blocks new enrollments until a new key is generated)
To pre-configure Agent Charley before a user logs in, write the enrollment key and desired policy settings to the MDM config directory before the app launches: 
/Library/Application Support/AgentCharley/config/mdm_enroll.json
/Library/Application Support/AgentCharley/config/mdm_policy.json
Contact your account rep for MDM deployment scripts compatible with Mosyle, Jamf, and Munki.

​
Device Groups

The Groups tab (next to the Devices list) lets you organize devices into named groups and apply group-scoped policy overrides. See Groups for full details.

​
Plan Limits

The Basic plan is limited to 1 active device. To enroll additional devices, upgrade to Pro or Enterprise from the Billing page.