Skip to main content
This Library Item is available for Mac computers
Iru Endpoint lets you upload and deploy custom apps to your enrolled Mac devices. Add Custom App library items to make sure all required applications are ready for your users.

​
Installers

Iru Endpoint supports several different installer types:
  • .PKG: Iru Endpoint supports compressed PKG and MPKG files.
  • .ZIP: With ZIP files, you can specify where the contents should be decompressed.
  • .DMG: DMG files are extracted to the /Applications folder. If your DMG contains a PKG, extract the PKG first and upload that instead.
Iru Endpoint’s maximum file upload size is 5 GB.

​
Installation Options

​
Execution Frequency

Depending on the app you want to deploy, you can specify whether Iru Endpoint should install it once or continuously monitor and ensure it’s installed.
  • Install once per device: Iru Endpoint installs the Custom App once. If the app is removed from the Mac, it won’t be reinstalled automatically. Use this for software patches that shouldn’t run continuously.
    • If a pre-install script fails, the Kandji Agent won’t attempt to install the Custom App, and it will run this Custom App Library Item again on the next check-in.
    • If a post-install script fails, the Kandji Agent will run this Custom App Library Item again on the next check-in, regardless of whether the Custom App was successfully installed.
  • Audit and enforce: Iru Endpoint runs the audit script and ensures it passes (exits 0) at each check-in, including before the first install. If the audit script exits anything other than 0, Iru Endpoint reinstalls the application automatically.
  • Install on demand from Self Service: The item is only offered as an optional install from Self Service. After execution, the Install button becomes Reinstall.

​
Audit Script Considerations

Audit scripts give you control over what qualifies as a pass. Does the app need to be in a specific location? Have a particular checksum? Be on a certain version? You can check all of these with an audit script. Example: This audit script checks for the presence of an app; if it’s not present, the script prompts Iru to reinstall it.
audit-app-presence.sh
#!/bin/bash
APPPATH="/Applications/zoom.us.app"
if [ -e "$APPPATH" ]; then
exit 0
else
exit 1
fi
To enforce a specific version of an installed app, use the Minimum Enforced Version script available on our Iru Support Github.

​
Pre- and Post-Install Scripts

Pre- and post-install scripts let you customize the install process for custom apps. Use a pre-install script to remove another app that’s being replaced. A post-install script can configure the custom app that was just installed.

​
Self Service Considerations

There are important considerations when using custom apps with Self Service.
  • When a custom app’s enforcement option is set to Install and continuously enforce or Install once per device, you can still show this item in Self Service. This is useful if users need to reinstall the software.
  • When a custom app’s Enforcement option is set to Install on demand from Self Service, the app won’t be installed until the user installs it from Self Service.
    • When installing via Self Service, the latest version of the app is installed.
    • Iru Endpoint automatically takes over management of non-App Store licensed apps if set to Install on demand from Self Service (as long as the bundle ID matches the Apps and Books version). Your global or per-app update settings are respected.

​
Restart

Some applications require a reboot after installation to operate correctly. Iru Endpoint can trigger the restart to ensure proper functionality. Check the Restart after successful install box to have Iru Endpoint restart the computer after the custom app is installed.
Users will be given a 30-minute countdown before the restart occurs.

​
Status

The status tab in a Custom App library item shows which Mac devices are waiting for the app to be installed, which ones have successful installations, and which ones are reporting installation errors.

​
Blueprints

To deploy your custom app to enrolled Mac computers, add it to a Blueprint. All Mac computers assigned to that Blueprint receive the custom app during their next check-in.

​
Articles

Use this guide to learn how to use the Custom App feature in Iru.

​
Troubleshooting

Note on Zip file uploads If the zip file contains a package and you see a Gatekeeper notification warning on a Mac during the custom app install process, run this command from a Terminal session on the package to clear the quarantine bit before zipping and uploading the install file to Iru.
clear-quarantine.sh
xattr -dr com.apple.quarantine "/path/to/package.pkg"