Recommended Jamf policy
- Upload the DockPilot Client package from your customer dashboard to Jamf Pro.
- Upload your organisation Licence mobileconfig as a Jamf configuration profile.
- Use the Admin Client to export the Dock policy mobileconfig or Jamf custom settings plist.
- Scope the Client package, licence profile, and Dock policy profile to a small pilot Smart Group first.
- Publish approved apps in Self Service so DockPilot can respond when users install or remove them.
Ready-to-copy Jamf policy notes
Policy name: Install DockPilot Client
Trigger: Recurring Check-in and Enrollment Complete
Execution frequency: Once per computer
Packages: DockPilot-Client.pkg
Scope: Pilot Smart Group, then production Smart Group
Configuration profiles:
- DockPilot licence mobileconfig
- DockPilot Dock policy mobileconfig or Jamf custom settings profile
Self Service: Optional; use Self Service for apps DockPilot should react to
Ready-to-copy Jamf script check
Use this as a lightweight post-policy check when testing. It does not change the Dock by itself; it confirms the client can read configuration and report status.
#!/bin/zsh
if [[ -x /usr/local/bin/dockpilot ]]; then
/usr/local/bin/dockpilot status
else
echo "DockPilot command line tool is missing"
exit 1
fi
What users experience
- The Dock can update when managed apps appear or disappear.
- Apps that are not part of your Dock policy are not automatically added.
- User Dock items can remain in place when your policy allows user flexibility.
- DockPilot should not remove a user's existing Dock just because the Mac is offline or the licence cannot be checked.
Deployment order
- Install the licence mobileconfig first or at the same time as the Client package.
- Install the Client package on managed Macs.
- Deploy the Dock policy profile created by the Admin Client.
- Test with a small smart group before wider rollout.
- Check DockPilot diagnostics if a Mac does not behave as expected.
Updating DockPilot
When a new package is available in the customer dashboard, download it and deploy it with your normal Jamf package workflow. DockPilot does not force automatic client updates.