DPDockPilotSign In
EducationEnterprisePricingDocsSign UpContact

Docs

Troubleshooting

Fix common DockPilot deployment, licensing, and Dock update issues.

Dock is not updating

  • Confirm the DockPilot Client package is installed on the Mac, not only the Admin Client.
  • Confirm the licence mobileconfig is installed on the Mac.
  • Confirm the Dock policy profile has been deployed to the right user or device scope.
  • Open DockPilot and check Licensing & Organisation for managed update status.
  • If the app is marked missing in DockPilot, install the app first through Self Service or your MDM app catalogue.
  • Use Copy Diagnostics or export a support file before raising a ticket.

DockPilot says not configured

  • Install the licence mobileconfig from your customer dashboard.
  • Make sure the profile is scoped to the Mac you are testing.
  • If using Jamf, check the Mac has received the configuration profile.
  • Refresh DockPilot or wait for the background client to pick up the profile.

Trial or licence expired

DockPilot pauses future managed Dock actions when a trial or subscription is no longer active. Existing Dock items are left in place. Sign in to the customer dashboard to check billing status or contact support if the licence state looks wrong.

An app icon looks incomplete

If an app is still downloading or installing, DockPilot may wait before applying it. Let the app finish installing, then refresh DockPilot or wait for the next background check.

Support file

DockPilot includes safe diagnostics that avoid exposing full enrolment or device tokens. Attach the exported support file to a portal ticket when asking for help.

Complete uninstall

If you want DockPilot fully removed from a Mac, follow the Complete Uninstall article. Remove the DockPilot configuration profiles from Jamf or MDM first so they are not re-delivered. The uninstall script removes DockPilot files but does not reset the user's current Dock layout.

  • Remove the Mac from any Jamf or MDM scopes that would reinstall DockPilot.
  • Remove DockPilot licence and Dock policy profiles from the Mac.
  • Run the support uninstall script as root.
curl -L https://dockpilot.io/support/uninstall_dockpilot.sh -o /tmp/uninstall_dockpilot.sh
sudo zsh /tmp/uninstall_dockpilot.sh