Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iru.com/llms.txt

Use this file to discover all available pages before exploring further.

Custom Scripts are available for Mac computers and Windows devices

​
What is a Custom Script?

Custom scripts in Iru Endpoint are a powerful way to automate tasks and configure settings on managed devices. Think of them as a set of instructions that can be deployed and executed on enrolled devices using the Iru Agent. With custom scripts, you can configure device settings, install or update software applications, run maintenance tasks, and enforce security policies. You can also use custom scripts to collect device information, like hardware inventory or system logs. A collection of prebuilt and regularly maintained scripts is available in our GitHub repository.
Iru Endpoint’s Custom Script Library Item can deploy scripts in various languages. However, our support team is best equipped to help troubleshoot scripts written in shell, bash, zshell, or Python. Support can also assist with AppleScript, provided it is invoked by one of the supported languages.

​
How Custom Scripts Work

The Iru Agent runs custom scripts on enrolled Mac computers. Your custom script can specify any shell or interpreter on the Mac computer. If a shell or interpreter is not specified, the default shell (/bin/sh) is used. Custom scripts are always executed as the root user.

​
Execution Frequency

Depending on the script you want to deploy, you can specify whether it will be run once at every check-in, once per day, or on-demand from Self Service.
For Install once per device, Iru reruns the audit script at each check-in until the Library Item reaches Pass for that device. If a remediation script is enabled and succeeds, the Library Item can show Remediated, but Iru still reruns the audit script on later check-ins until it reaches Pass.
The script will be run at each check-in (~ every 15 minutes).
The script will be run every 24 hours based on the previous run time.
The script will never be run automatically and will only be offered as an optional item from Self Service. After executing the item, the Run button will be relabelled Run again.
The Custom Script Library Item can also be offered via Self Service in the first 3 scenarios above.

​
Exit Codes and Outputs

If the audit script exits with code 0, that run has Pass status. If the audit script exits with any non-zero exit code, that run has Error status. When a run has Error status, Iru generates an alert. See our Global Alerts support article for details.
Stdout and Stderr are recorded in the script’s audit information, which can be found on the device status page or custom script status page.

​
Remediation

A remediation script allows the main Audit Script to be used as a true audit script to check for system configuration or application state. If the audit script exits with any non-zero exit code, that run has Error status; Iru then runs the remediation script.
If the remediation script exits with code 0, the Library Item status for that device is Remediated. If the remediation script exits with a non-zero exit code, the Library Item status for that device is Error, and Iru generates an alert. See our Global Alerts support article for details.

​
Restart Options

The restart option allows you to force a restart after a successful script execution. When selecting this option, the user will receive a restart timer from the Iru Agent menu bar application. This timer will be a 5-minute restart timer if the item was initiated from Self Service or a 30-minute restart timer if initiated in another way such as during a check-in.
The restart option will behave differently based on the use of a remediation script:
  • If a Remediation script is being used, when the Remediation script exits 0, this will trigger the restart countdown.
  • If a Remediation script is not being used, when the Audit script exits 0, this will trigger the restart countdown.

​
Add a Custom Script Library Item

To add this Library Item to your Iru Endpoint Library, follow the steps outlined in the Library Overview article.
1

Name the Library Item

Give the new Custom Script Library Item a Name.
2

Assign to Blueprints

Assign to your desired Blueprints.
3

Select Execution Frequency

Select an Execution Frequency.
4

Configure Self Service (optional)

Optionally, make the script available in Self Service.
5

Add Audit Script

Paste your script into the Audit Script field.
6

Add Remediation Script (optional)

Optionally, configure and paste a Remediation Script.
7

Configure restart option (optional)

If desired, check the box to Restart after a successful execution.
8

Save configuration

Click Save.

Library Overview

Curate, create, and manage Library Items and add them to Blueprints

Configuring Blueprints

Create and configure device Blueprints for policy management

Deploy Homebrew Using a Custom Script

Deploy Homebrew to Mac computers using a custom script

Global Variables

Learn how to use global variables in Iru Endpoint to dynamically insert device and user information into profiles, scripts, and configuration settings.

Global Alerts

Configure how Iru Endpoint surfaces alerts when Custom Scripts or other Library Items report issues