# Create and Install a Custom App on macOS

## Before you Start

Make sure you have the following configured before you start:

* Faronics Deploy Agent Installed on the Computers you wish to install the applications on.

## How to **Create and Install a Custom App on macOS**&#x20;

![Install a Custom App on a Mac](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUKsJhRYp73GjLDd4k%2F-MUULPM1jup86gr8Fc1E%2Fimage.png?alt=media\&token=001cd59f-0375-4846-a096-1b022739b02a)

1\. Select the **Control Grid** tab on the top menu bar.

2\. Navigate to the **Applications** tab.

3\. Scroll down to the **All Mac** grid.

4\. Click the Custom App button<img src="https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MTpmZHgo_rLDGYl7iFn%2F-MTpt4IWJviPv0ZLX-LP%2Fcreatecustombutton.png?alt=media&#x26;token=aad3e540-cac7-41e3-9f87-caf5770a9a70" alt="" data-size="original">

5\. Select **Create Custom App - Mac**.&#x20;

**Specify Custom App Details**

![Specify Custom App Details](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUKsJhRYp73GjLDd4k%2F-MUUMsy-gzOy9jTom-Mb%2Fimage.png?alt=media\&token=7e5b1971-53c3-4d4f-9182-0645bfb85388)

5\. Enter a **Package Name**, Macs Fan Control in this example.

6\. Enter a **Bundle Name;** this will be the name of the application that gets installed in the Applications folder on your mac (Macs Fan Control.app in this example).

{% hint style="info" %}
Install the application prior to creating the Custom App in Faronics Deploy so that you can locate the bundle name in the Applications folder (usually a .app filename).&#x20;

Make sure you remove the application before proceeding as running the installer on a computer where the application already exists might uninstall the application and result in loss of user data or cause a failure during the installation stage.
{% endhint %}

7\. Enter the **URL** to download the install package from (this needs to be a **ZIP**, **DMG**, or **TAR** file) <http://faronics.org/proservices/macsfancontrol.zip> in this example.

8\. Set the **Package Type** (ZIP, DMG or TAR).

9\. Set **Restart** to either **Always** or **Not Set**.&#x20;

10\. Set the install time out; the default is set to **10** (minutes). Specify an install timeout that will be sufficient for the complete application installation.

11.Click the **Next** Button.

**Select Computer to Install**

![Select the Computer to Install the Custom App on](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUNRQWBCJckJuZcsQI%2F-MUUPE6ORIUC-TInK_bo%2Fimage.png?alt=media\&token=c9ea362f-0201-41b3-8c53-aa5fd9e23c80)

12\. Select the name of the computer to install this Custom App on (**iMac-01** in this example).

{% hint style="danger" %}
Ensure that it does not have the application already installed. Running the installer on such a computer might uninstall the application and result in loss of user data or cause a failure during the installation stage.
{% endhint %}

13\. Click the **NEXT** button.

**First time install**

14\. Click the **INSTALL** button to proceed with the install.

![Install Macs Fan Control (Custom App) on iMac-01](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUNRQWBCJckJuZcsQI%2F-MUUPn9Tj8WNHzi7PYi2%2Fimage.png?alt=media\&token=5893206e-6360-4a3d-8a8c-70a02048408a)

15\. Click the blue INSTALL button to confirm the install.&#x20;

<img src="https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUNRQWBCJckJuZcsQI%2F-MUUQ0u90g5t_DlD2WLR%2Fimage.png?alt=media&#x26;token=f9b1dc42-f821-4e2b-b8a0-5ee7c01f3466" alt="" data-size="original">&#x20;

16\. The Custom Application (Macs Fan Control in this example) will now download.

![Custom App downloading](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUNRQWBCJckJuZcsQI%2F-MUUSmGVVARa5sf0CHxW%2Fimage.png?alt=media\&token=178984f1-c076-4727-8ff4-17d452d0fd95)

17\. Once downloaded, the Custom App will automatically install.

![Custom App Installing for the First Time](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUNRQWBCJckJuZcsQI%2F-MUUT7n7taWkSSqCdnt7%2Fimage.png?alt=media\&token=88f43bb4-6d09-4968-b96c-6cce6f4fe000)

18\. The Custom App has now been installed. Click **DONE** to finish.

![First Time Install Complete](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MUUTDZthyA_W6TWf0jx%2F-MUUTUw7KO2TOFdWKJNj%2Fimage.png?alt=media\&token=300d3e03-d4e3-439a-a348-eb06e0cc9d34)

{% hint style="info" %}
If this application is already installed on other computers, it may take up to 60 minutes to sync the status from the other computers to Faronics Deploy.
{% endhint %}

{% hint style="success" %}
The Custom App is now ready to be installed on other computers via the Applications grid.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faronics.com/faronicsdeploy/application-management/macos-apps/install-application-on-mac-os/install-a-custom-app-external-on-macos/add-a-custom-app-on-mac-os.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
