Where Does Nudge Store Config on Mac?
Nudge reads macOS update deadlines from /Library/Preferences/com.github.macadmins.Nudge.json config.
Last updated
Nudge stores required macOS versions and deadlines in a JSON file under Library Preferences. Admins deploy it directly or through MDM profiles. A per-user plist tracks first-run grace state beside it.
Profiles and files merge with profiles winning conflicts. The LaunchAgent runs Nudge at login to enforce the dates. Keep JSON dates in ISO format since Apple requires that shape for profile payloads.
Where Nudge stores this, by platform
/Library/Preferences/com.github.macadmins.Nudge.json (per-user plist beside it)
Required versions and dates in system JSON. Per-user grace state in home plist. MDM profiles merge with files. Missing JSON stops the UI.
Frequently asked questions
How do I update Nudge deadlines?
Push a new JSON or profile with updated dates and versions. Nudge reloads prefs when profiles change. Test with print-json-config to confirm the client sees the new values.
Nudge will not launch. What do I check?
Check the per-user plist for grace state plus the system JSON for required versions. MDM profiles land in Managed Preferences instead. JSON file missing means the UI will not launch.
Notice an outdated path? Let us know.