---
title: "Deploying Custom Apps"
slug: "deploying-custom-apps"
updated: 2025-07-22T18:29:20Z
published: 2025-07-22T18:29:20Z
canonical: "support.kandji.io/deploying-custom-apps"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.kandji.io/kb/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploying Custom Apps

### Add an App to your Kandji Library

To add this Library Item to your Kandji Library, follow the steps outlined in the [Library Overview](/kb/library-overview) article.

1. Complete the following items:
  - **Custom App Name**: Display name of the app within Kandji Library and Blueprints.
  - Give the Custom App an **Assignment** of one or many Blueprints.
  - **Execution Frequency**: Specify if Kandji should attempt to install this package once per device, or have the package enforced.
  - **Choose Package Type**: Choose from Installer Package, Disk image, or ZIP file.
  - **Pre-install Script**: Provide a script to be executed before the package is run.
  - **Upload Installer**: Attach a .pkg, .dmg, or .zip file with the desired package to deploy (The maximum file upload size is 5 GB).
    - If you choose a .zip file type, you will have an additional field to define an unzip location.
    - If you choose a .dmg file type, the disk image must contain only a .app file in order to function as desired.
  - **Post-Install Script**: Provide a script to be executed after the package is run.
  - **Restart after successful install**: Specify if a Mac should restart after the package (and scripts, if provided) are deployed.
2. Click **Save.** ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/uxtk5ka8ahdexfmgug_7x4spq3yktrwusq.png)

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

### Configure an Assignment Map to deploy a Custom App

1. Navigate to **Blueprints** in the left-hand navigation bar.
2. Select the **Assignment Map** you'd like to add the Custom App to.
3. Click **Edit Assignments** in the upper right corner. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-0957AM.png)
4. Drag your Custom App from the left side of the Assignment Map to your desired node on the map.
5. Click **Save**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/Kandji-Support-KB-1003AM.png)

1.