The Devices page gives you full visibility and control over every machine running a Turen agent in your organization. Navigate to Platform Settings > Devices in the sidebar.
Fleet View
The fleet view at /agents shows all registered devices with stats and management controls.
Agent Download
Download the latest macOS agent DMG directly from the dashboard using the download button at the top of the page.
Stats Row
Four stat cards summarize your fleet:
- Total Devices — Number of registered devices
- Active — Devices with active status, with percentage
- Suspended — Devices that have been manually suspended, with percentage
- Version Distribution — Top 3 agent versions with percentages
Fleet Table
The fleet table shows:
| Field | Description |
|---|
| Agent | Machine hostname, agent version, OS/architecture, and username |
| Last Checkin | When the device last reported in |
| Actions | Suspend, activate, or delete the device |
Filtering
Use the status filter tabs to show:
- All — Every registered device (with count)
- Active — Devices with active status (with count)
- Suspended — Devices that have been manually suspended (with count)
- Deleted — Devices that have been soft-deleted (with count)
Results are loaded with paginated infinite scroll.
Device Detail
Click on any device to view its full details at /agents/:clientId:
- Hostname, username, and platform information
- GPU details
- Registration date and registration key used
- Client ID and machine ID
- Agent version and generation
- Clone detection status (flags if the agent appears to be running in a cloned VM/container)
Device Status
Devices have the following statuses:
| Status | Meaning |
|---|
| Active | Device is registered and authorized to operate |
| Suspended | Device has been manually suspended by an admin |
| Deleted | Device has been soft-deleted from the organization |
Suspending a Device
If you need to temporarily disable a device — for example, during an investigation — you can suspend it:
- Go to Platform Settings > Devices
- Click on the device (or use the inline action button)
- Click Suspend Device
A suspended device’s proxy will stop accepting requests.
Deleting a Device
To remove a device from your organization:
- Go to Platform Settings > Devices
- Click on the device
- Click Delete Device
Deleting a device removes it from your fleet. The machine will need a new registration key to rejoin.
Update Channel Settings
The Turen agent updates itself automatically. You can control how updates are delivered to your fleet from Platform Settings > Device Settings.
Release Channels
Choose which release track your agents follow:
| Channel | Description |
|---|
| Production | Stable releases — recommended for most organizations |
| Beta | Pre-release versions for early testing before general availability |
| Alpha | Cutting-edge builds — may contain experimental features |
Version Offset
Set a version offset (0–5) to keep your agents a set number of releases behind the latest version on the selected channel. This gives you a buffer to evaluate new releases before they roll out to your fleet.
For example, with the production channel and a version offset of 2, your agents will run the version that is two releases behind the latest production release.
Pinned Version
If you need to lock your fleet to a specific agent version — for example, during a compliance freeze or while troubleshooting — enter the exact version number (e.g., v0.1.30) in the pinned version field. Agents will stay on this version until the pin is removed.
Pinning a version disables automatic updates. Your agents will not receive security fixes or improvements until the pin is removed.
How Auto-Updates Work
- On each checkin, the agent checks for a newer version based on your channel, offset, and pin settings.
- If an update is available, the agent downloads and verifies the new version.
- The agent applies the update and restarts automatically.
- If the new version fails to start, the agent rolls back to the previous working version.
No manual reinstall or intervention is needed — updates happen in the background.
Registration Keys
Registration keys for onboarding new machines can be managed under Platform Settings > Org Settings > Agent Settings. See Registration Keys for detailed documentation. 
