A stand-alone macOS app to help MacAdmins more easily deploy Setup Your Mac
As announced during JNUC 2023, BIG-RAT (a.k.a. Leslie Helou), does it yet again by providing the MacAdmins community SYM-Helper, a stand-alone macOS app to help MacAdmins more easily deploy Setup Your Mac.
Previously, when configuring Setup Your Mac, MacAdmins had to painstakingly convert their Jamf Pro policies to perfectly formatted
JSON, cross their fingers — but not too many — and hope for the best.
Now, with SYM-Helper, a familiar, intuitive interface helps administrators build a near production-ready, customized Setup Your Mac script — with double-click and drag-and-drop ease — in minutes.
Learn how to use SYM-Helper to quickly build a near production-ready, customized Setup Your Mac script.
Please report bugs and submit feature requests on GitHub.
An open-beta version of SYM-Helper
0.7.6 was officially released on 19-Sep-2023 in conjunction with JNUC 2023.
See: 2. Download
0.7.6 supports Setup Your Mac versions
1.10.0 (and later).
In the traditional sense, SYM-Helper doesn’t open files, it generates
Setup-Your-Mac.bash (based on a GitHub-hosted source script, merged with settings you specify with the SYM-Helper app).
Settings > Script Source can be changed to any GitHub-hosted URL; in the following example, the
development branch has been manually specified.
At any time, click Generate Script to “save” your customized Setup Your Mac script.
Pro Tip: The various SYM-Helper settings files — where in-progress work is automatically saved — can be accessed by holding down Option while clicking the Settings icon.
The original goal of SYM-Helper was to help MacAdmins with the tedious work of adding Jamf Pro policies to a Configuration’s
policyJSON (a.k.a. the “main” Setup Your Mac dialog).
Then, over-achiever Leslie also added an easy way to enable / disable items in the “Welcome” dialog (i.e., SYM-Helper > Settings > Prompt For …)
“Near production-ready” means that not every Setup Your Mac setting is currently exposed to the SYM-Helper GUI and, you, the Jamf Pro administrator, are responsible to use your favorite editor to modify the SYM-Helper-generated
Setup-Your-Mac.bash for your production environment.
For example, when a Jamf Pro policy includes data in the Self Service fields, SYM-Helper can fully populate a
However, for a Local Validation, there’s (currently) no way to enter a
icon in the SYM-Helper GUI:
(Local validations are but just one example, there are certainly other examples which will require manual editing; see: Setup Your Mac > Configuration.)
The list of configured servers is shared among Leslie’s apps and is available at the following location:
Please backup then delete the above file then try again.
See Issue No. 5.