> ## 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.

# Self Service Settings

> Configure Self Service portal settings in Iru Endpoint. Customize branding, enable platforms, set categories, and control which items users can install.

### 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.

<Note>
  As of **April 8, 2026**, apps were updated from **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" /> to **Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" /> 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](/en/iru/platform-overview/iru-brand-update) and [Upgrade to Iru](/en/iru/platform-overview/upgrade-to-iru).
</Note>

### How It Works

Self Service is automatically installed on all enrolled devices and provides a customizable interface for application distribution. On macOS devices, **Iru Self Service** is installed in the `/Applications` folder, while on iOS, iPadOS, and visionOS devices, the **Iru Self Service** App Store app 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:

<Steps>
  <Step title="Navigate to the Library">
    Navigate to the **Library** section in the left-hand navigation bar.
  </Step>

  <Step title="Select Self Service Tab">
    Select the **Self Service settings** tab.

    <Frame>
      <img src="https://mintcdn.com/iru/ZekSCbYzzHVHf14r/assets/media/images/iru-self-service-settings.png?fit=max&auto=format&n=ZekSCbYzzHVHf14r&q=85&s=09923539130cfd9512a482934bcbd10e" alt="Library with Self Service settings tab selected" width="3370" height="1938" data-path="assets/media/images/iru-self-service-settings.png" />
    </Frame>
  </Step>

  <Step title="Open Customization">
    Click **Customize**.
  </Step>
</Steps>

### 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.

<Note>
  The Self Service preview may not show up on lower-resolution displays, including Retina displays in High DPI mode.
</Note>

#### 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.

<Steps>
  <Step title="Enter Header Text">
    Enter **Header** text that will be displayed in the Self Service header banner.
  </Step>

  <Step title="Enter Subheader Text">
    Enter **Subheader** text that will be displayed under the header.
  </Step>
</Steps>

#### Configuring Logo

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.

<Steps>
  <Step title="Upload Logo">
    Click the **Upload** link, locate your logo in the Finder, and click the **Open** button.
  </Step>

  <Step title="Preview Logo">
    Your logo will be displayed where the default logo was previously, and you will see it in the preview.
  </Step>

  <Step title="Add Dark Mode Logo">
    After you upload a custom logo, you can also add a logo for computers in Dark Mode.
  </Step>
</Steps>

To remove the custom logos:

<Steps>
  <Step title="Hover Over Logo">
    Hover over the custom logo in the **Customize** Self Service panel.
  </Step>

  <Step title="Delete Logo">
    Click the **Trash** button. Your custom logo will be replaced with the default logo.
  </Step>
</Steps>

### 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

<Steps>
  <Step title="Click Add Category">
    Click **Add category** in the bottom right corner of the **Categories** section.
  </Step>

  <Step title="Enter Category Name">
    Enter a **Name** for the new category (maximum 64 characters in length).
  </Step>

  <Step title="Add Description">
    Enter an optional **Description** for the category.
  </Step>

  <Step title="Search for Icon">
    Optionally, enter a search term for an icon in the Search field.
  </Step>

  <Step title="Select Icon">
    Choose an icon for the category.
  </Step>
</Steps>

#### Changing the Category Order

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

<Steps>
  <Step title="Drag Categories">
    Drag the categories using the slide bars on the left side of the Categories section.
  </Step>
</Steps>

#### Editing or Deleting an Existing Category

<Steps>
  <Step title="Access Category Options">
    Click the three dots to the right of the category you want to edit or delete.
  </Step>

  <Step title="Edit Category">
    Click **Edit** to change the category name, description, or icon.
  </Step>

  <Step title="Delete Category">
    Click **Delete** to delete the category. You can't delete the Recommended or All categories.
  </Step>
</Steps>

### Considerations

<CardGroup cols={2}>
  <Card title="Branding and logos" icon="image">
    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.
  </Card>

  <Card title="Previews" icon="eye">
    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.
  </Card>

  <Card title="Categories" icon="diagram-project">
    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.
  </Card>

  <Card title="Apple platforms" icon="apple">
    Self Service is available on **macOS**, **iOS**, **iPadOS**, and **visionOS**. Spot-check the catalog on each platform your organization supports.
  </Card>

  <Card title="Header and subheader" icon="message">
    Use **Header** and **Subheader** for IT contact details and short guidance users should see at the top of Self Service.
  </Card>

  <Card title="End-user guidance" icon="book">
    Tell users how to open Self Service and what it is for. For walkthroughs aimed at end users, see [Self Service for macOS](/en/endpoint/settings/self-service/self-service-for-macos) and [Self Service for iOS, iPadOS, and visionOS](/en/endpoint/settings/self-service/self-service-for-ios-ipados-and-visionos).
  </Card>
</CardGroup>
