Managing Devices
The Devices page lists every Windows and macOS device enrolled in your Pckgr environment. Devices appear here on their own once the agent is installed and enrolled.
In short
- To add devices, click Add devices, which opens Agent Setup. Each device appears here on its own once its agent enrolls.
- Your device limit is shared by every tenant in your account. At 100%, new enrollments are rejected.
- Click a device to open its page: a context row, a health strip and tabs with the detail.
- Check in works on every device. Restart, Shut down and Remote Control work on Windows devices only.
- Device naming renames newly enrolled devices only, and the new name needs a restart to take effect.
- To find a device by the name people know it by, such as
Reception PC, give it a nickname. The device itself is not renamed.
The device list
- Hostname
- The computer name, or the assigned name if device naming is enabled. A nickname, if the device has one, shows underneath.
- OS
- Operating system and version (for example Windows 11 23H2), with a Windows or Apple icon.
- Agent
- Version of the Pckgr agent installed.
- Status
- Connection status: Online, Away, Offline or Dormant.
- Last Seen
- How long ago the device last checked in.
- Groups
- Number of groups the device belongs to.
Click the Hostname, Status or Last Seen header to sort the table; the other built-in columns don't sort. The search bar matches hostname, nickname, last logged-on user, OS version, agent version, every custom field value and the values in any columns you have added. To find someone's computer, type part of their sign-in name, such as smith for AzureAD\JaneSmith.
Filters
- Platform
- Only Windows or only macOS devices.
- Last seen
- Devices seen in the last 24 hours, or devices not seen for more than 7 days (the same devices the dashboard’s inactive devices alert counts).
- Outdated or failed update
- Devices still on an older agent a day after the current one was released, and devices whose last agent update attempt failed. The first show an Outdated badge, the second an Update failed badge with the reason. A device simply waiting its turn in a rollout shows neither.
Filter by device details
Open the filter
Click Filter above the table and choose a field. Every column you can add is there, custom fields included, as well as the ones the table always shows.Set the condition
Choose how to compare and enter a value. The choices follow the field: text contains, is or is not; numbers is, is more than or is less than; dates in the last or more than a number of days ago, before or after a day; yes/no fields is. Every field also takes is empty and has a value.Add it
Click Add filter. It shows as a chip above the table; click its × to remove it. Add more and the list shows only devices that match all of them.
Filters are kept in the page address, so you can bookmark a filtered list or send the link to a colleague. Clear filters resets the search, the drop-downs and every field filter at once.
Add columns
Click Columns above the table to add more of the device record to the list. The choices are the same as the group CSV export, grouped as:
- Device
- Assigned name, last logged-on user, enrolled date, update ring, device ID.
- OS & updates
- OS build, last boot, last update scan, pending quality updates, latest quality update and when it installed.
- Hardware & network
- Serial number, manufacturer, model, BIOS, disk encryption, private IP addresses, time zone, inventory date.
- Custom fields
- Every custom field your tenant defines.
Click an added column's header to sort by it, and the search bar matches its values too. Dates show in your own time zone. Your choice is remembered in this browser.
Connection status
| Status | Indicator | Meaning |
|---|---|---|
| Online | Green (pulsing) | Checked in within the last 7 minutes. |
| Away | Yellow | Checked in 7–30 minutes ago. |
| Offline | Gray | Checked in more than 30 minutes ago. |
| Dormant | Gray (outline) | No check-in past the dormant threshold. |
| Blocked | Red | The device has been blocked from operating. |
| Inactive | Gray | The device has been marked inactive. |
Device usage
Your device limit is shared by all the tenants in your account. The Devices page header shows how many device slots are in use across all tenants, for example "15 of 25 device slots used across all tenants (60%)".
- From 90% of your limit, a warning banner appears on the Devices page. Contact support to increase your capacity.
- At 100%, the banner says the device limit has been reached and new enrollments are rejected until capacity is increased. Devices that are already enrolled keep working.
Rejected devices don't retry
The device page
Click any device row to open its detail page. The page is laid out in three bands:
- Context row
- Under the device name: platform, connection, status, when it was last seen, and the groups it belongs to. Click a group chip to open the group, or the + to add the device to another group.
- Health strip
- One tile each for Compliance, Updates, Security, Encryption and Storage (free space on the system drive). Each tile summarises that signal (for example “3 / 3 compliant” or “36 CVEs”); click it to open the tab with the detail. Compliance, Updates and Security are Windows-only, so Macs show two tiles: Encryption and Storage.
- Tabs
- Overview (device, agent, network and power, storage, custom fields, and a More details section), Apps (assigned and detected), Security, Updates, Policies, Groups, Deployments and Activity. Security, Updates and Policies are shown for Windows devices only, as are custom fields and the CVE column of the detected apps.
The selected tab is kept in the page URL, so you can link a colleague straight to, say, a device's Security tab.
System information
- Hostname, OS version and agent version.
- Nickname, with a pencil button to add, change or remove it (see Give a device a nickname).
- Last agent update: whether the most recent agent self-update Succeeded, Failed, was Recovered by the agent's update watchdog, or Recovery failed, with the target version, when it happened and any error. Shown once the agent has reported an update attempt. Failed and recovered updates also appear in the audit log as Agent Update Failed and Agent Update Recovered. After a failed update a Windows device is offered that version again a day later, not straight away.
- Enrollment date and last check-in time.
- Windows Update status on the Updates tab: OS build, latest KB, pending updates, and whether each is downloaded or waiting for a restart.
- Serial number, if reported by the agent.
- Assigned name and rename status, if device naming is enabled.
Hardware and environment
The agent collects a set of hardware and environment facts shortly after it starts, then refreshes them every six hours. Until the first collection lands, the card explains that nothing has been reported yet. The Inventory collected time under More details tells you how fresh the values are.
- Model
- Manufacturer and model, read from the system firmware. Placeholder values some OEMs ship (such as “To Be Filled By O.E.M.”) are shown as blank rather than repeated back to you.
- Last user
- The account currently signed in, or the most recent one if the device is at the lock screen. The device reports it and it updates on its own, so it can’t be assigned. To label a device with who or what it is for, give it a nickname.
- Last reboot / Uptime
- Uptime counts up continuously in the browser, so it stays accurate between check-ins instead of freezing at the last reported value.
- EncryptionOn, Off, Encrypting, Decrypting, Suspended or Unknown
- BitLocker state of the OS volume on Windows, FileVault on a Mac, shown on the Encryption tile of the health strip. Unknown means the state could not be queried (on Windows, usually because BitLocker is not installed); it does not mean the device is unencrypted.
- Private IP
- IPv4 addresses of the device’s active adapters. Hypervisor and VPN adapters are excluded so the value reflects the real network the device is on; a Mac reports its Ethernet and Wi-Fi interfaces.
- Time zone
- The device’s configured zone and its current UTC offset, including daylight saving.
- BIOS version / released
- Firmware version and release date (under More details), useful for spotting fleets that are behind on firmware. A Mac shows its system firmware version; Apple publishes no release date.
- A field stays blank when that particular probe found nothing. A failed probe never overwrites a value that was previously reported, so one bad collection will not blank out details you already had.
- Macs report the same facts once their agent has updated itself, with the model shown as its name and identifier (for example “MacBook Air (MacBookAir10,1)”). Apple Silicon Macs have no base clock or memory slots to report, so those rows are left out. A Mac on an older agent reports its model and serial number only.
Last user is personal data
Apps tab
- Assigned
- All applications assigned to this device through its group memberships.
- Detected
- Software detected on the device (from Programs & Features), searchable by application name. For supported apps, an Uninstall button removes the app from this single device without going through the catalog or assignments. To see an app across every device, use Software Inventory.
Uninstall a detected application
The Uninstall button appears next to apps that publish a way to be uninstalled silently. Pckgr supports:
- MSI packages
- Pckgr rewrites the install command to a quiet uninstall (
/X /quiet /norestart). - Apps that publish a
QuietUninstallString - In their registry uninstall key. This is typical for installers built with Inno Setup, NSIS and most modern packaging tools.
If an app is missing both, the button is hidden, because Pckgr can't guarantee a non-interactive uninstall and the user would see a prompt on the device.
Click Uninstall next to the app.
A confirmation dialog appears with the app name.Confirm.
An uninstall job is queued for this device.Wait for the device's next check-in.
The agent runs the silent uninstall command within about 5 minutes; click Check in to make it sooner.Check the result in the Deployments view.
It includes the exit code and any output, and is labelled "Custom uninstall" to distinguish it from catalog-managed jobs.
While an uninstall is queued or running, the row shows an "Uninstalling" badge instead of the button. After a successful uninstall, the app is removed from the Detected Applications list on the next inventory scan.
What's blocked
- Pckgr Agent and Pckgr Self-Service Portal
- No Uninstall button. Removing the agent through this flow would orphan the device with no recovery path; use the dedicated agent removal flow instead.
- Apps without an MSI or QuietUninstallString
- No button. Remove the app from the device manually, or uninstall it through Pckgr’s catalog if it’s catalogued there.
Security, Deployments, Updates, Groups and Activity tabs
Security
The Security tab (Windows devices) shows CVE vulnerabilities specific to this device. Each catalog-linked app with open CVEs appears as an expandable card showing:
- App name, installed version and CVE count.
- An Update to vX button when the catalog has a fix, with the number of CVEs it resolves.
- When expanded, the individual CVEs with severity, patch status, affected version range and a link to the NVD entry.
See Vulnerability Tracking for more on how vulnerability tracking works.
Deployments
The Deployments tab lists recent app deployments (installs and uninstalls) for this device, showing the app, intent, status, exit code, and when each job was created and completed. Click one to view its full details and logs.
Updates
The Updates tab shows the device's recent Windows Update installation history.
Groups
The Groups tab lists all groups the device belongs to. Click Add to group to add the device to an existing group. To remove the device from a group, open the group and remove it there.
Activity
The Activity tab lists the actions taken on this device, newest first, with when each happened and who did it: restarts and shutdowns, forced check-ins, detected app uninstalls, catalog updates, rename retries, nickname changes, ring moves, group additions and removals, cancelled and retried deployments, remote desktop and remote shell sessions, what was done in remote file manager sessions, and chats started and ended.
Entries Pckgr records itself, such as a remote session ended automatically or a failed agent update, show Pckgr (automatic) as the person. Use Refresh to load new entries and Previous and Next to page back through older ones.
These are the same entries the Audit Log records, narrowed to this one device.
Remote access
The device page has buttons for working on a device directly from your browser. Remote Control, Remote Shell and Files each open in a new tab; Chat opens a panel on the device page itself. A session tab stays with the tenant it was opened from, so you can switch tenant in your main tab and keep the session running. The tab shows that tenant's name, and leaving it for Settings or the device page makes that tenant the active one again.
- Remote Control
- Starts a remote desktop session. The button is hidden when remote desktop is turned off for the tenant, and it is disabled for Macs and for devices that aren't online.
- Remote Shell
- Opens a remote shell on a Windows or macOS device. It is shown to Owners and Admins, and to MSP Technicians when the Account Owner allows it.
- Files
- Opens the remote file manager on a Windows device, to browse its drives and upload or download files. It is shown to the same people as Remote Shell.
- Chat
- Opens a live chat with the person signed in to a Windows device. It is shown to Owners, Admins and MSP Technicians, is disabled for devices that aren't online, and is not shown on Macs.
Force a check-in
Click the play button on a device row, or Check in on the device page, to request an immediate check-in.
- A device on the current agent is told straight away over its live connection and checks in within seconds, checking every assigned app again and refreshing its installed apps and, on Windows, its Windows Update status and hardware inventory. The device page waits for the response and reloads with what the device reported.
- A device that is offline or on an older agent picks the request up on its next scheduled check-in (about every 5 minutes) and then picks up any pending jobs.
Restart or shut down a device
Click the restart or power button on a device row, or open the Power menu on the device page and choose Restart or Shut down.
Confirm.
The user sees a notification and the device restarts or shuts down 30 seconds later.
Restart and Shut down work on Windows devices only, so Macs don't show these buttons.
Warning
Delete a device
Click the trash icon on a device row and confirm the deletion.
Important
Devices that have been dormant for a long time can also be removed for you: see Automatic cleanup of dormant devices in Settings. Those removals appear in the Audit Log as Delete Device by Pckgr (automatic).
Give a device a nickname
A nickname is the name people know a device by when it isn't the hostname: Reception PC for DESKTOP-4F7K2QX, or Boardroom display. It is a label in Pckgr only. Nothing changes on the device, and its hostname stays as it is.
Open the device's page.
In the Device card, the Nickname row shows the current nickname, or None.Click the pencil button next to it.
Type a nickname of up to 64 characters.Click Save.
The nickname shows under the hostname on the device page and in the device list. To remove it, click Remove or save an empty box.
The search bar on the Devices page, the device search on the Policies page and the device picker when you add a device to a group all match nicknames. You can also add a Nickname column to the device list, filter on it, and include it in a group's CSV export.
Nicknames don't have to be unique
Reception PC. Each change is recorded in the audit log as Set Device Nickname. Owners, Admins and MSP Technicians can set nicknames; Read Only and MSP Read Only can see them.Device naming
When device naming is enabled in tenant settings, newly enrolled devices are renamed automatically using a template you define. For example, ACME-{Counter:4} produces ACME-0001, ACME-0002 and so on.
How it works
Configure a naming template in Settings > Device Naming.
A device enrolls with the Pckgr agent.
Pckgr generates the next name from the template and assigns it to the device.
On the next check-in, the agent receives a rename command and runs
Rename-Computeron the device.A toast notification tells the end user that a restart is required.
After restarting, the device reports back with the new hostname.
Rename status
Devices with an assigned name show their rename status on the device page's Rename row. The device list also shows a badge while a rename is in progress or after it fails.
| Status | In the device list | Meaning |
|---|---|---|
| Pending | Renaming | The rename command has been sent; waiting for the agent to run it and reboot. |
| Completed | — | The device has been successfully renamed. |
| Failed | Rename failed | The rename failed. Click Retry on the device detail page to try again. |
If a rename fails (for example on a domain-joined machine without domain credentials), the error message is shown on the device detail page. Click Retry to re-queue the rename command.
Good to know
- The naming template only applies to newly enrolled devices. Existing devices are not retroactively renamed.
- Generated names are limited to 15 characters (the Windows NetBIOS limit).
- You can skip renaming for individual devices during enrollment: check "Skip automatic device renaming" in the installer, pass
SKIP_RENAME=1for silent installs, or use--skip-renamewith the CLI. See Skipping Device Rename.
The rename needs a restart
Act on several devices at once
Select devices using the checkboxes.
Choose an action from the action bar at the bottom of the page.
- Force check-in
- Requests an immediate check-in for all selected devices. Connected Windows devices are woken straight away, check every assigned app again and refresh installed apps. The Windows Update and hardware rescan is reserved for the single-device Check in, so a large selection does not rescan all at once.
- Restart / Shut down
- Restarts or shuts down all selected Windows devices 30 seconds after you confirm. Macs in the selection are skipped and listed as not sent.
- Delete
- Removes all selected devices and their associated data.
Click the X on the action bar to clear your selection.