Settings

Configure your tenant's behavior, including device status thresholds, email notifications, remote access, and your subscription.

WindowsmacOSOwners and Admins change settings; Read Only can view; MSP Technicians and MSP Read Only don't see the page

In short

  • The subscription card, the API Keys tab and Delete Account are shown to Account Owners only.
  • Changes on the General tab are applied together with Save Changes. A company logo is saved as soon as you upload it.
  • Company branding is Windows only and reaches a device on its next deployment.
  • Remote Desktop is on by default; Remote Shell, the Remote File Manager and Chat are off until you turn them on.

Settings tabs

General
Everything described on this page.
API KeysAccount Owners only
Keys for the Public API.
Integrations
The Microsoft Entra ID connection used by Entra ID Groups.

Subscription and usage

The top card is shown to Account Owners only. It shows:

Plan
A badge with your current plan (Free or Pro), and the subscription status on a paid plan.
Device count
How many devices are enrolled across all tenants versus your plan limit.
Usage bar
Turns amber at 75% and red at 90% utilization.

Billing is self-serve from this card:

Free plan
Includes a small device allowance (the card shows how many device slots you have). To upgrade, enter the number of devices you need and click Upgrade to Pro. Pro is US$1 per device per month, with a minimum of 10 devices, and you can switch to annual billing in checkout for a lower price. Checkout asks for your billing address and shows your final price, including any tax. If you have subscribed before, the button reads Reactivate Subscription.
Pro plan
Click Manage Subscription to manage your subscription, including your device quantity. When you are approaching your device limit, the card reminds you to increase your quantity there.
Cancelling
If your subscription is set to end, the card shows the end date. After that, the account returns to the Free plan.

Device status thresholds

How device connection statuses are calculated:

StatusTrigger
OnlineHeartbeat within the last 7 minutes
AwayHeartbeat between 7 and 30 minutes ago
OfflineHeartbeat between 30 minutes and the dormant threshold
DormantNo heartbeat for longer than the dormant threshold

Dormant threshold

Dormant Threshold1–365 days, default 30
The number of days without a heartbeat before a device is marked as Dormant. This helps identify devices that may have been decommissioned, lost, or powered off for extended periods.

Automatic cleanup of dormant devices

Devices that are never coming back (retired, lost, reimaged without the agent) otherwise sit in the list for ever and keep using a device slot. Turn this on to have Pckgr remove them for you.

Remove dormant devices automaticallyoff by default
When on, Pckgr checks every hour and removes any device that has not checked in for the number of days below. Each removal is the same as clicking Delete on the device: the device, its jobs, detected apps, policy state and group memberships are removed, and its device slot is freed.
After7–365 days, default 90
How long a device must go without a check-in before it is removed. It must be at least the dormant threshold, so a device is always shown as Dormant before it disappears.

While the switch is on, the page shows how many devices would be removed at the next hourly check with the chosen wait, and names the first few, so you can see what you are about to lose before you save.

Every removal is written to the Audit Log as a Delete Device entry by Pckgr (automatic). When a check removes anything, the notification bell gets an entry and the notification recipients are emailed a summary listing the devices.

Important

Removal is permanent. A removed device that comes back online cannot check in; it has to be enrolled again. Pick a wait longer than the longest a device in your fleet is legitimately switched off, such as a seasonal worker's laptop or a lab machine.

Email notifications

Configure who receives email notifications and which types are enabled.

Notification recipients

Enter the email addresses that should receive notifications, one per line or separated with commas. Only these addresses will receive the enabled notification types.

Notification types

Toggle each notification type on or off:

App updates
Sent when application versions are updated in the catalog.
Enrollment tokens
Sent when enrollment tokens are created or deleted.
Groups
Sent when groups are created, updated, or deleted.
Users & permissions
Sent when users are invited, permissions changed, or invites revoked.
Device usage warnings
Sent when device usage reaches 80%, 90%, or 95% of your limit.
Security alerts (weekly CVE digest)On by default
A weekly summary of open CVEs across your devices, plus an immediate alert when a new critical CVE is detected. Only sent when at least one device is vulnerable. See Vulnerability Tracking.

Company branding

The name and logo your end users see when Pckgr installs or removes an app on their device, and in the Self-Service Portal. Branding applies to Windows devices only.

Organization name

Enter the name end users should see, for example "Contoso IT". It appears in three places:

  • The install prompt shown before an app is installed, updated, or removed, including the deferral and close-apps dialogs.
  • The attribution line on Windows toast notifications.
  • The Self-Service Portal header, unless you set a separate portal header name.
Organization NameUp to 64 characters
If left blank, end users see the generic "IT Department" label. The field stops accepting input at the 64 character limit and the counter underneath shows how much room is left.

Keep the name short. It renders on one line next to the action, as in "Contoso IT - App Installation", so a long legal entity name will crowd the dialog.

Already branding PSADT from Intune?

Devices branded through a PSAppDeployToolkit Group Policy (such as the ADMX profile and branding script used with Intune Pckgr) keep that branding until you set a name or logo here, which then takes priority on Pckgr deployments.

If a branding policy names a logo file that isn't on the device yet, the agent puts an image at that path before the install starts (your Pckgr logo if you have uploaded one, otherwise the icon in the app package), so interactive installs aren't blocked. Files already in place are never overwritten.

When changes take effect

The agent applies the name and logo at deploy time, so a device picks it up on its next deployment rather than the moment you save. There is no policy sync to wait for and no restart. Devices that install nothing stay unbranded until they do.

Install prompt branding requires a device running the latest agent. Devices on older agents keep showing the default label until they update, though their toast notifications are branded as before.

Deployment notifications

Show Deployment Toasts
Toggles the Windows toast notifications shown when an app is installed, updated, or removed. Individual apps can override this default from the app’s own settings. Turning toasts off does not affect install prompt branding, which Company Branding controls.

Remote Desktop

The Remote Access card holds the switches for all four remote tools: remote desktop, remote shell, the remote file manager and chat. Each has its own switch for the current tenant, and the card ends with the one account-wide switch for MSP Technicians.

Allow remote desktopOn by default
Switch it off for a tenant whose client doesn’t want remote access to their devices. It applies to the current tenant only, and only Owners and Admins can change it.

Warning

While it is off, the Remote Control button is hidden on every device in the tenant and no new remote sessions can start. Switching it off also ends any session already in progress.

Remote Shell

Controls Remote Shell, a recorded terminal on a Windows device (Windows PowerShell or Command Prompt) or a Mac (zsh or bash). Owners and Admins can open one, and MSP Technicians can when the Account Owner allows it; replaying recordings is for the Account Owner only.

Allow remote shellOff by default
Turn it on to let Owners and Admins open a shell on devices in this tenant.
Notify the signed-in userOff by default
Shows a notification on the device before a shell opens. Leave it off for silent troubleshooting; no consent prompt is shown either way. It can be changed only while remote shell is allowed.
Allow MSP Technicians to use remote shell and the file managerOff by default; Account Owner only
MSP Technicians can always use remote desktop. This also lets them open a shell in every tenant of your account where remote shell is allowed, and use the remote file manager where that is allowed. One switch covers the whole account. Admins see it but cannot change it.

Recordings are encrypted and kept for 30 days. These settings are saved with Save Changes along with the rest of the page.

Warning

Changing any of these settings is recorded in the audit log. Changing the first two ends any shell sessions in progress in this tenant; switching off technician access ends technicians' shell and file manager sessions across the account.

Remote File Manager

Controls the Remote File Manager, which lets Owners and Admins browse a Windows device's drives and upload, download, rename and delete files there. MSP Technicians can use it when the Account Owner has switched on Allow MSP Technicians to use remote shell and the file manager.

Allow the remote file managerOff by default
Turn it on to let those roles open the Files page of the Windows devices in this tenant. It is as powerful as remote shell: someone who can replace files as the system account can also run programs on the device. It is saved with Save Changes along with the rest of the page.

Warning

Changing this setting is recorded in the audit log. Switching it off ends any file manager sessions in progress in this tenant.

Chat

Controls Chat, which lets Owners, Admins and MSP Technicians type live with the person signed in to a Windows device. MSP Technicians need no extra switch for it, and the person at the device cannot start a chat.

Allow chat with device usersOff by default
Turn it on to let those roles use the Chat button on the Windows devices in this tenant. Messages are not saved: the Audit Log records who chatted with which device and when, never what was said. It is saved with Save Changes along with the rest of the page.

Warning

Changing this setting is recorded in the audit log. Switching it off ends any chats in progress in this tenant.

Device naming

Automatically rename newly enrolled devices using a template. When enabled, the agent renames the Windows machine to match the assigned name.

Turn on device naming

  1. Toggle Enable Device Naming on.

  2. Enter a naming template, for example ACME-{Counter:4}.

  3. Click Preview to see the next generated name.

  4. Click Save Changes.

Template format

The template is a prefix followed by {Counter:N}, where N is the number of zero-padded digits.

Template1st device2nd device3rd device
PC-{Counter:4}PC-0001PC-0002PC-0003
ACME-{Counter:3}ACME-001ACME-002ACME-003
W-{Counter:5}W-00001W-00002W-00003

Generated names must be 15 characters or fewer (Windows NetBIOS limit). The preview will warn you if your template produces names that are too long.

Counter

The counter automatically increments with each enrollment. You can adjust the Next Counter Value to skip numbers or reset after a bulk re-enrollment.

How the rename works

When a device enrolls with naming enabled:

  1. Pckgr generates the next name and tells the agent to rename the device.

  2. The agent renames the Windows machine.

  3. A toast notification tells the end user that a restart is required.

  4. The device reports the rename result back to Pckgr.

A restart is needed

The rename requires a restart to take effect, and the agent does not automatically reboot the device. You can send a restart command from the Devices page when ready. See Managing Devices for rename status details and troubleshooting.

Skip the rename for specific devices

To enroll a device without renaming it (for example a server, a kiosk, or a machine that already has the correct name), skip the rename at install time:

  • Check Skip automatic device renaming in the interactive installer.
  • Pass SKIP_RENAME=1 for silent installs.
  • Use --skip-rename with the CLI.

See Skipping Device Rename in the agent installation guide for full details.

Self-Service Portal

Enable the Self-Service Portal to let end users install IT-approved apps on their own devices. See the Self-Service Portal guide for full details.

Enable Self-Service Portal
Toggle the portal on or off for all devices in this tenant.
Portal header nameDefaults to your Organization Name
Name displayed in the portal header, for example “Contoso IT”. Only set this if the portal should be titled differently from the name on your install prompts.
Logo
The portal shows your company logo from Company Branding.

When you disable the portal, the agent removes the application, Start Menu shortcut, and Add/Remove Programs entry from all devices on their next check-in.

Save changes

After making changes, a "You have unsaved changes" message appears. Click Save Changes to apply. The button is disabled when there are no pending changes.

Danger Zone

Shown to Account Owners only, at the bottom of the General tab. Type DELETE in the box to enable the button.

Deleting the account cannot be undone

Delete Account permanently deletes your account and all its tenants, users, devices, groups, jobs and associated data.

Tenants

Go to Settings > Tenants to manage tenants in your account. Tenants provide isolated environments within your account. Each tenant has its own devices, apps, groups, and settings, and users can be granted different access levels per tenant.

Create a tenant

Only Account Owners see the Create tenant card.

  1. Enter a name for the new tenant.

  2. Optionally set a dormant threshold.

    Defaults to 30 days.
  3. Click Create tenant.

Edit a tenant

Update a tenant's name or dormant threshold directly in the table, then click Save.

Delete a tenant

Account Owners can delete a tenant with the trash icon on its row and confirm. The account's only tenant cannot be deleted.

Important

This permanently deletes the tenant and all its devices, apps, groups, policies, scripts and associated data.