Push your first policy
Send a managed-policy field to the lab machine and see it take effect.
EasyCC reads managed policy from a platform-specific location on every launch. Pushing a single field through proves that the wiring works. Pick the platform you're testing.
Where the policy lives
| Platform | Path |
|---|---|
| Windows | HKLM\Software\Policies\EasyCC (enforced) and HKLM\Software\Policies\EasyCC\Recommended (defaults) |
| macOS | /Library/Managed Preferences/com.easycc.app.plist. Top-level keys are enforced; keys under a recommended dictionary are defaults. |
This matches Chrome Enterprise's convention — if you have an ADMX workflow for Chrome already, EasyCC works the same way.
Push a field on Windows
The lab walkthrough uses PowerShell directly so you don't need an MDM yet.
Open PowerShell as administrator
Right-click PowerShell, then Run as administrator.
Pin the release channel to stable (enforced)
New-Item -Path 'HKLM:\Software\Policies\EasyCC' -Force | Out-Null
Set-ItemProperty 'HKLM:\Software\Policies\EasyCC' -Name 'release_channel' -Value 'stable' -Type StringQuit and relaunch EasyCC
Managed-policy values are read on launch. Fully quit (right-click the tray icon → Quit, or use Task Manager) and relaunch.
Confirm the lock icon
Open Settings → About. The release channel field now shows a small lock icon and the tooltip "Managed by your organization — you can't change this." Settings → Advanced shows the same lock affordance on the channel selector.
Push a field on macOS
The lab walkthrough writes the plist directly. In production you'd push it via Jamf, Workspace ONE, Kandji, or Mosyle.
Build the plist
Save this as com.easycc.app.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>release_channel</key>
<string>stable</string>
</dict>
</plist>Drop it in the managed preferences folder
sudo cp com.easycc.app.plist /Library/Managed\ Preferences/
sudo chmod 644 /Library/Managed\ Preferences/com.easycc.app.plistQuit and relaunch EasyCC
Cmd-Q out of EasyCC and reopen it from /Applications/.
Confirm the lock icon
Same as Windows — Settings → About and Settings → Advanced show the locked field.
What if the lock doesn't appear?
| Check | Fix |
|---|---|
| Did EasyCC fully quit? | The policy is read once on launch. A reload-from-tray won't pick it up. |
| Did you write to the right path? | On Windows, HKLM (machine), not HKCU (user). On macOS, /Library/Managed Preferences/ (managed), not /Library/Preferences/ (regular). |
| Is the value type correct? | Strings as strings, booleans as booleans. Mismatched types are silently ignored with a log warning. |
If it still won't apply, see A policy isn't applying.
Removing the policy
To roll back the lab change:
Windows (PowerShell):
Remove-ItemProperty 'HKLM:\Software\Policies\EasyCC' -Name 'release_channel'macOS:
sudo rm /Library/Managed\ Preferences/com.easycc.app.plistRestart EasyCC. The lock icon disappears and the user's own setting comes back.
Next
How is this guide?