These example scripts are meant for use with MDM to run Installomator and process installs. Examples are also included which use swiftDialog to provide user feedback and dockutil to add app icons to the dock.

There are basically two ways to use Installomator with MDM. The “Jamf way” is where, through the MDM admin interface, your upload the Installomator script to a policy, and you provide additional parameters in the policy configuration like which app to install. The “other way” to use Installomator is by having the MDM install Installomator locally on the computer, just once, and then on subsequent runs the MDM runs a script which calls Installomator and provides the parameters.

Examples of MDMs which use the “other way” are Mosyle Manager/Mosyle Business, Addigy, and Microsoft Endpoint Manager (Intune).

The scripts utilizing swiftDialog require version 10 of Installomator. If Installomator version 9 is installed, it will set NOTIFY=all and use the traditional Installomator notifications for showing progress, where as on version 10 it will be NOTIFY=silent as swiftDialog is used instead.

Abbreviations used in script names

SS — Self Service — scripts designed for use through a Self Service catalog
VFA — valuesfromarguments — a custom label call to Installomator. When using an MDM and the "other way", you can use these scripts to provide the label variables to Installomator for custom labels.

Condition scripts

Scripts with the condition suffix are for use with MDMs like Addigy, where a script is run to determine if the rest of the policy should run.

Prevention scripts

The Installomator 1st and Progress 1st scripts are meant to run automatically upon device enrollment. They check for the existance of a file, /var/db/.Installomator1stDone, to determine whether the computer has already been deployed. You can run the prevention scripts on existing Macs to ensure the 1st scripts won't inadvertently run on them.

"Jamf" folder

This folder has Jamf specific examples using swiftDialog as part of the Installomator installation. Perfect for use with Jamf Self Service. Separate ReadMe-file in this folder.

Scripts to install prerequisites

Use these scripts to handle installing Installomator itself. Additionally, you may want to install swiftDialog manually instead of having Installomator install it.

install Installomator direct.sh — can be run at enrollment and as maintenance at any time to install Installomator.
install swiftDialog direct.sh — can be used at enrollment and as maintenance at any time to install swiftDialog.

Once Installomator has been installed, dockutil can be installed by Installomator, using this script:

App-install/App service Auto-install.sh — This script uses pre-installed installomator to install dockutil.

Enrollment scripts

For enrollment purposes, some 1st-scripts has been created. One runs silently, another is using DEPNotify to show progress and feedback:

Installomator 1st Auto-install DEPNotify.sh — will install DEPNotify first, start that up, and change progress on the installation bar at each installed label. Very good for Addigy an Microsoft.
Installomator 1st Auto-install.sh — runnning silently installing Installomator labels in the given order. Can be used in combination with the Progress-script.
Progress 1st swiftDialog.sh — It will install swiftDialog and start that up with a list of software it will look for. It will look for an installed file/folder in the file system for each item. This is great if some apps are being installed outside of Installomator, like by Apple Apps & Books, and then this script can show when it has been installed.

There are also Self Service versions of the above.

“App-install”-folder

App browser-security Auto-install.sh
App browser-security SS.sh
App normal Auto-install.sh
App normal SS.sh
App service Auto-install.sh
App VFA.sh

Here you can use scripts for Self Service (SS) or for Auto-install. There will be a difference in how many notifications will be used and maybe handling of blocking processes.

browser-security: For an app like a web browser, you’ll want the install performed right away, so there isn’t a deferral option. normal: The user can defer/skip the update. service: These are apps where we don’t need to ask the user to allow the update. Menu bar apps and utilities would fall under this category.

“App-install SS with swiftDialog and dockutil”-folder

App browser-security SS.sh
App normal SS multi-app.sh
App normal SS.sh
App service SS.sh
App VFA SS github.sh
App VFA SS.sh

These scripts are similar to the App-install folder but also utilize swiftDialog to show user feedback and installation status, and they also have an option to use dockutil to add the installed software to the Dock.

App-update

A common requested behavior is to only update an app if it is already installed. These script verifies if the app is already installed before runnning Installomator.

App browser-security Auto-install.sh
App normal Auto-install.sh

README.md Unescape Escape

Scripts for use with MDM