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.

​
About Self Service Settings

Self Service acts as an internal app store for your users to self-install applications you make available to them. It provides a centralized way for users to discover and install approved applications while maintaining security and compliance standards.
As of April 8, 2026, apps were updated from Kandji to Iru branding. The Self Service app name changed from Kandji Self Service to Iru Self Service. Please update scripts, automations, and utilities that still reference the old app names. For more information, see Iru Brand Update and Upgrade to Iru.

​
How It Works

Self Service is automatically installed on all enrolled devices and provides a customizable interface for application distribution. On macOS devices, it’s installed in the /Applications folder, while on iOS, iPadOS, and visionOS devices, it’s deployed as an App Store app and appears on users’ Home Screens. Administrators can customize the appearance, organization, and functionality to match their organization’s branding and requirements.

​
Configuring Self Service

Self Service allows users to install apps in macOS, iOS, iPadOS, and visionOS. Auto Apps and Managed OS are available only in macOS. To customize Self Service:
1

Navigate to the Library

Navigate to the Library section in the left-hand navigation bar.
2

Select Self Service Tab

Select the Self Service settings tab.
Library with Self Service settings tab selected
3

Open Customization

Click Customize.

​
Configuring Branding and Preview

You can customize the Self Service app with your company’s name, logo, or other information. There are built-in previews to see how Self Service will look to your users, in both Light and Dark Modes and on each Apple platform.
The Self Service preview may not show up on lower-resolution displays, including Retina displays in High DPI mode.

​
Configuring Header and Subheader

You can set a custom title and optional message for the Self Service banner. One good use of this space: to provide users IT-support contact information.
1

Enter Header Text

Enter Header text that will be displayed in the Self Service header banner.
2

Enter Subheader Text

Enter Subheader text that will be displayed under the header.
Upload your company’s logo, which will be displayed next to the header in Self Service. A square logo (128x128 pixels) in PNG format with a transparent background is recommended.
1

Upload Logo

Click the Upload link, locate your logo in the Finder, and click the Open button.
2

Preview Logo

Your logo will be displayed where the default logo was previously, and you will see it in the preview.
3

Add Dark Mode Logo

After you upload a custom logo, you can also add a logo for computers in Dark Mode.
To remove the custom logos:
1

Hover Over Logo

Hover over the custom logo in the Customize Self Service panel.
2

Delete Logo

Click the Trash button. Your custom logo will be replaced with the default logo.

​
Managing Categories

Several default categories are provided to help organize your Self Service apps. Recommended and All are the first two categories and will always be available. Other categories can be added, reordered, renamed, or deleted.

​
Adding a Category

1

Click Add Category

Click Add category in the bottom right corner of the Categories section.
2

Enter Category Name

Enter a Name for the new category (maximum 64 characters in length).
3

Add Description

Enter an optional Description for the category.
4

Search for Icon

Optionally, enter a search term for an icon in the Search field.
5

Select Icon

Choose an icon for the category.

​
Changing the Category Order

Categories will display in Self Service in the same order in which they appear on the Self Service Settings page.
1

Drag Categories

Drag the categories using the slide bars on the left side of the Categories section.

​
Editing or Deleting an Existing Category

1

Access Category Options

Click the three dots to the right of the category you want to edit or delete.
2

Edit Category

Click Edit to change the category name, description, or icon.
3

Delete Category

Click Delete to delete the category. You can’t delete the Recommended or All categories.

​
Considerations

Branding and logos

Align logo, colors, and header copy so Self Service feels like one catalog. Prefer square 128×128 pixel PNG logos with a transparent background, then add a Dark Mode logo after you customize Light Mode.

Previews

Use the built-in previews for Light Mode, Dark Mode, and each platform before you rely on a design in production. The in-page preview may not appear on lower-resolution displays, including Retina displays in High DPI mode.

Categories

Order and name categories for quick scanning, choose icons that match each group’s purpose, and remember Recommended and All cannot be deleted. Revisit categories as your app portfolio changes.

Apple platforms

Self Service is available on macOS, iOS, iPadOS, and visionOS. Spot-check the catalog on each platform your organization supports.

Header and subheader

Use Header and Subheader for IT contact details and short guidance users should see at the top of Self Service.

End-user guidance

Tell users how to open Self Service and what it is for. For walkthroughs aimed at end users, see Self Service for macOS and Self Service for iOS, iPadOS, and visionOS.