Configuration Profile Keys

Required Keys

AppInstalls Key

[array of dict]

AppWatch Key

[array of dict]

---

Optional Keys

runLocal Key

[bool]
default: false

This option is used to toggle between deployment and testing modes.

Setting runLocal to true will configure macOS Onboarder to testing mode. This disables full-screen blur for the swiftDialog window and requires an admin password to be entered in an interactive way (for example, if ran through terminal you will get a password prompt in the terminal window)

Setting runLocal to false will configure macOS Onbaorder to deployment mode. This assumes that the script is deployed and run with root privileges through the Jamf School Scripting Module. macOS Onbaorder will run with full-screen blur enabled, resulting in a locked screen for end users during the onboarding workflow.

If this key is not present in the configuration profile it will default to false (Deployment Mode)

Running macOS Onboarder locally without setting this key to true will result in failed Installomator installations

appLogging Key

[bool]
default: false

This option is used to toggle standard or verbose logging of the process that converts configuration profile items into array items to be ran by the macOS Onboarder script.

Setting appLogging to true will log the Icon Location, Display Name and Installomator Label for each app in the AppInstalls key and Icon Location, App Location and Display Name for each app in the AppWatch key.

Use the verbose log to ensure that each element has been correctly read from the configuration profile and the exact string that has been inserted into the script array

Navigate to /var/tmp/jsmacOSOnboarder.log to view log

If this key is not present in the configuration profile it will default to false

userGreeting Key

[bool]
default: false

This option is used to toggle between the logged in username or the computer name in the mainWindow title.

Setting the UserGreeting to true will display the username of the logged in user.

Setting the UserGreeting to false will display the computer name

If this key is not present in the configuration profile it will default to false

mainMessage Key

[string]
default: Lets install some apps on your device! This might take a while....

completeTitle Key

[string]

completeMessage Key

[string]