This guide applies to Mac computers
Label
Add a Label to distinguish this Library Item from other instances of the same Auto App (e.g., “For Marketing, Notifications Off”). Labels are not displayed to end users; they appear only in the Iru Endpoint Web App. Use labels when you add the same Auto App multiple times with different Blueprint assignments or settings. For steps that apply to any Library Item, see Library Item Labels in Library Overview.Assignment (Blueprint)
Under Assignment → Assignment Maps, use Blueprint and + Assign to control which devices or users receive this Auto App. Assign the Library Item to the Blueprint(s) that should receive it.Installation Method
Under Installation, choose how the Auto App is installed:- Continuously enforce: The app is installed and kept up to date automatically on assigned devices.
- Install on-demand from Self Service: The app is not pushed; users install it from Self Service when ready.
- Update only: Updates are enforced if the app is already installed, but the app is not installed on new computers and is not made available in Self Service.
Self Service
Under Self Service, add this Library Item to Self Service by turning on the Available in Self Service toggle. Then configure:- Category: Specify the Self Service category this Library Item displays under. Categories help users find apps in the Self Service library. Recommended items are also displayed in a “Recommended” section at the top of the Self Service library page and categories list.
- Recommended: When selected, the item appears in that Recommended section.
Self Service Customization
Click Customize to change the name and content that display in Self Service. The description is shown on the item detail page in Self Service.1
Customize name
Turn on the toggle to override the default Library Item name displayed in Self Service. Enter a custom name (maximum 30 characters).
2
Display a description
Turn on the toggle to show a description on the item detail page. Choose Display provided description (from the Auto App) or Display custom description (up to 4,000 characters). A Copy button is available to copy the provided description.
3
Require users to read the description before installing
Optionally check Require users to read the description before installing so users must view the description before they can install.
4
Display a link
Turn on the toggle to include a support article or documentation link on the item detail page. Set Text button label (e.g., “More information”; maximum 32 characters) and Button URL. Any URL scheme recognized by the OS can be used, including https://, mailto://, and file://.
Enforcement
Under Version enforcement, choose how updates are managed for the Auto App. The controls below appear in the Library Item in this order, depending on the option you select.Do not manage updates
Iru installs the latest available version of the Auto App but does not update existing installations as new versions are released.Automatically enforce new updates
With this option, updates are enforced automatically after release and Iru installs the latest update of the Auto App. Under Enforcement timeframe, select how long after an update is released before it is enforced: Available options: 1 day, 2 days, 1 week, 2 weeks, 3 weeks, 1 month, 2 months, 3 months Then set the time zone and time as described in Time zone and time, and optionally configure Phased rollout. At the bottom of the Enforcement section, the Library Item shows the current minimum allowed version and the upcoming schedule of when newer versions will be enforced based on the Enforcement timeframe.Manually enforce a minimum version
Specify a Minimum version (the floor) for the Auto App. Useful for critical security updates or aligning devices to a version by a date. With this option, Iru installs the latest update on devices below the minimum; it does not leave devices on the minimum version if a newer update is available. Configure Enforcement deadline, Time zone and time, and optionally Phased rollout.Manually enforce a specific version
Under Select a version, choose the exact Auto App version to enforce, including a version lower than the latest available. This is the only Version enforcement option that does not always update devices to the latest version of the Auto App. Configure Enforcement deadline, Time zone and time, and optionally Phased rollout.Enforcement deadline
Set the date by which the version requirement must be met, then set the time zone and time as described in Time zone and time.Time zone and time
These controls appear under Enforcement timeframe or Enforcement deadline, depending on the option. Select a named time zone or Device’s Local Timezone, then choose the time of day. For a named time zone, enforcement is determined server-side from that zone (for example, 5:00 PM PST). For Device’s Local Timezone, the selected time applies in each device’s local time. The update is cached on devices. Iru tries to install it automatically if the app is closed. If the app is open, users can voluntarily update before the enforcement time.Phased rollout
Optionally select Enable phased rollout, then set Rollout window (hours) to a whole number between 24 and 168 hours (1-7 days). Devices are offered the update gradually over that window, which helps reduce download and caching spikes for large installers. Initial installs are not affected. When phased rollout is enabled, Iru uses an algorithm that considers the configured rollout window together with device-specific data to determine when each device becomes eligible. Per-device timing appears in the Library Item Status tab. For more, see Library Item Status Activity Timeline. If Vulnerability Response settings are in use, they override the Phased rollout settings.Auto App Notifications
When notification settings are modified, an updated Configuration Profile is not redistributed until the next daily MDM check-in. To trigger an immediate check-in, run sudo update-mdm on the client Mac.- Unsupported: If an Auto App does not post to Notification Center, notifications are not available to customize.
- Unmanaged: End users control notification settings. This is the default when an Auto App is added and configured for the first time.
- Managed: A Configuration Profile with a notifications payload is installed alongside the Auto App. Use the following steps to configure it:
1
Enable notification management
Turn on the toggle to enforce management of notifications for the Auto App.
2
Allow or disallow notifications
Set whether notifications are allowed or disallowed. If disallowed, no further options are available and notifications are disabled for the Auto App.
3
Set notification style
Select None (available in Notification Center only), Banner (default; upper-right corner, auto-dismiss), or Alert (stays until dismissed).
4
Configure critical alerts
Optionally enable critical alerts so the app can ignore Do Not Disturb and ringer settings.
5
Configure lock screen and Notification Center
Toggle Show notifications on lock screen and Show in Notification Center.
6
Configure badge and sounds
Toggle Badge app icon and Play sound for notifications.
7
Set notification preview visibility
Choose Always, When unlocked, or Never.
8
Set notification grouping
Choose Automatic (default), By app, or Off.
Options
At the end of the Auto App configuration, the Options section includes the following:- Add to Dock during install: When enabled, Iru adds the app icon to the Dock during initial app install, or during re-install if the app is found to be missing. Iru does not automatically re-add the icon to the Dock if the app is updated.
- Run preinstall script: The script runs before the app is installed. It must have an exit code of 0 to be considered successful.
- Run postinstall script: The script runs after the app is installed. It must have an exit code of 0 to be considered successful.
Related Articles
Auto Apps Overview
Deploy pre-packaged applications across platforms
Understanding Auto App Settings for Windows
Configure installation, Self Service, and update enforcement for Auto Apps on Windows