0. Before You Begin
If the core functionality of Setup Your Mac meets your needs, writing code should not be required.
However, you must be comfortable modifying scripts before implementing this approach in production (i.e., customizing existing settings for your use-case, reading and editing JSON, etc.).
The Jamf Training Catalog, which is free to all Jamf customers, is a great place to start learning the basics.
The #setup-your-mac Channel on the MacAdmins Slack and is a great resource for best-effort support when implementing Setup Your Mac in your environment.
Please remember that the more than 1,200
#setup-your-macChannel members also have full-time jobs, all of who need to also meet their employers' deadlines.
To the best of my recollection, Setup Your Mac (1.5.0) was the first time I’d publicly posted code which I considered to be knowingly incomplete and not fully tested (for the simple reason that we don’t use the additional input fields introduced in version 1.5.0 in our environment).
When you observe code blocks which include the following comment, please be aware that “you’re on your own.”
# UNTESTED, UNSUPPORTED "YOYO" EXAMPLE
Submit feature requests on GitHub and please note that while all requests are welcome, finding available cycles to custom-code a feature we won’t use in our production environment is always challenging.
Before submitting a bug report, please use the following snippet to download a fresh, time-stamped version of Setup-Your-Mac-via-Dialog.bash and ensure you can replicate the unexpected behavior:
timestamp=$( date '+%Y-%m-%d-%H%M%S' ) ; curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash https://raw.githubusercontent.com/setup-your-mac/Setup-Your-Mac/main/Setup-Your-Mac-via-Dialog.bash ; sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash
Please also review the open swiftDialog issues to help determine the source of the issue.