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

# Configure the Mac Custom App Library Item

> Upload and deploy custom applications to Mac computers using the Custom App Library Item. Support PKG, DMG, and ZIP formats with pre and post-install scripts.

<Callout icon="apple" color="#B84A7A" iconType="regular">The Mac Custom App Library Item is available for Mac computers</Callout>

The **Mac Custom App** Library Item lets you deploy custom applications (PKG, DMG, ZIP) to Mac computers. For details on installers, execution options, scripts, and troubleshooting, see the [Custom Apps Overview](/en/endpoint/library/library-items-profiles/custom-apps-overview).

## Create a Mac Custom App Library Item

To add this Library Item to your Iru Endpoint Library, follow the steps outlined in the [Library Overview](/en/endpoint/library/library-items-profiles/library-overview) article.

<Steps>
  <Step title="Navigate to Library">
    Navigate to the **Library** and select **Add Library Item**.
  </Step>

  <Step title="Select Mac Custom App">
    Search for and select **Mac Custom App**.
  </Step>

  <Step title="Name the Library Item and assign to Blueprints">
    Give the Library Item a **Name** and assign it to one or more **Blueprints**.
  </Step>

  <Step title="Set execution frequency">
    Set **Execution Frequency** to install once per device, audit and enforce, or install on demand from Self Service. For more, see [Execution Frequency](/en/endpoint/library/library-items-profiles/custom-apps-overview#execution-frequency) in the overview.
  </Step>

  <Step title="Choose package type">
    Choose **Package Type** (Installer Package, Disk image, or ZIP file). See [Installers](/en/endpoint/library/library-items-profiles/custom-apps-overview#installers) in the overview for details.
  </Step>

  <Step title="Upload installer">
    Attach a .pkg, .dmg, or .zip file (maximum 5 GB). If you use a .zip file, you can set an unzip location; if you use a .dmg, the image must contain only a .app file. See [Installers](/en/endpoint/library/library-items-profiles/custom-apps-overview#installers) in the overview for details.
  </Step>

  <Step title="Add scripts (optional)">
    Optionally add **Pre-install** and **Post-install** scripts. See [Pre- and Post-Install Scripts](/en/endpoint/library/library-items-profiles/custom-apps-overview#pre-and-post-install-scripts) in the overview for details.
  </Step>

  <Step title="Configure restart and save">
    Optionally check **Restart after successful install**. Click **Save**. [Restart](/en/endpoint/library/library-items-profiles/custom-apps-overview#restart) has more on this.
  </Step>
</Steps>

The new Mac Custom App will now appear in your Library and be ready to be added to a Blueprint.

### Configure an Assignment Map to Deploy a Mac Custom App

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

  <Step title="Select Assignment Map">
    Select the **Assignment Map** you'd like to add the Mac Custom App to.
  </Step>

  <Step title="Edit assignments">
    Click **Edit Assignments** in the upper right corner.
  </Step>

  <Step title="Drag Mac Custom App to node">
    Drag your Mac Custom App from the left side of the Assignment Map to your desired node on the map.
  </Step>

  <Step title="Save changes">
    Click **Save**.
  </Step>
</Steps>

### Related Articles

<CardGroup cols={2}>
  <Card title="Custom Apps Overview" icon="box" href="/en/endpoint/library/library-items-profiles/custom-apps-overview">
    Deploy custom applications to Mac and Windows devices
  </Card>

  <Card title="Configure the Windows Custom App Library Item" icon="microsoft" href="/en/endpoint/library/library-items-profiles/configure-the-windows-custom-app-library-item">
    Step-by-step setup for Windows Custom Apps (MSI, EXE)
  </Card>
</CardGroup>