# Create and Install a Custom App

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

## Create a Custom App and Install For The First Time

![](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULMaqfSZvrCz5JsZMv%2F-MULR5p9gT0DNdnSXzoj%2Fimage.png?alt=media\&token=7d3f01f4-cd36-4a84-8e58-447631859905)

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

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

3\. Click on the **Custom Apps** drop-down menu.

4\. Select **Create Custom App**.&#x20;

5\. Enter a package name under **Custom App Details**.

![Configure Custom App](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULRHsI7bGlp_Sx9uYz%2F-MULRWdnnP1mqO12Ih9w%2Fimage.png?alt=media\&token=01d0b82b-16a6-4f99-81b9-333d9a9ad9a7)

6\. Enter a **URL** or **Network Path** to where the installer/uninstaller is located.

{% hint style="info" %}
If entering a network path, enter user credentials that have the necessary rights to access the shared file. See [Hosting - URL or Network Path](https://docs.faronics.com/faronicsdeploy/application-management/install-uninstall-and-update-apps/install-application-s/install-external-application-s-custom-app/create-and-install-a-custom-app/hosting-a-custom-app-url-or-network-path) for further information on hosting.
{% endhint %}

a. If you enter a zip file in the URL path, this will be automatically extracted. Once extracted the executable will be run.&#x20;

b. The **Extract compressed file and run executable** option is checked, this cannot be unchecked if a zip file is in the path above.&#x20;

c. **Required**: If you entered a zip file in the URL path above, you will need to enter the name of the executable file which will be run upon extraction.

<figure><img src="https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRkQfx_2cLnNNBX1muO%2Fuploads%2F4rvlK7ISopqVSgjTRfKq%2Fimage.png?alt=media&#x26;token=00e1711e-df8c-404e-9c01-3ef7ffcb6496" alt=""><figcaption></figcaption></figure>

7\. Enter **Install** or **Uninstall** in the Command line parameters.

{% hint style="info" %}
If using a **.msi** file, you don't need to enter the **/n** or **/qn** switches for a silent install.

If using a **.exe** file, you will need to enter the supported switches for a silent/unattended installation, **/S** in this example.
{% endhint %}

8\. Click **Next**.

9\. Select the **Computer Name** from the list to install the **Custom App** for the first time (ensure that the computer doesn't already have the application installed).&#x20;

![Select a Computer to Install the Custom App on for the First Time](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULRHsI7bGlp_Sx9uYz%2F-MULRzjgNPBgol72sYuI%2Fimage.png?alt=media\&token=ffd4eb26-d0a9-408f-9513-abc3cba66263)

{% hint style="info" %}
This installs the custom app on one machine to verify that the package details are correct.
{% endhint %}

10\. Click **Next**.

11\. Click the **Install** button.

![Install the Custom App](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULRHsI7bGlp_Sx9uYz%2F-MULSI5boMNa6t8qNP6X%2Fimage.png?alt=media\&token=efc283fb-9456-4b2f-852c-8d38294a95a1)

12\. Confirm the install by clicking **Install** when prompted.&#x20;

<img src="https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULRHsI7bGlp_Sx9uYz%2F-MULSPUjBl6XeVfmqWOU%2Fimage.png?alt=media&#x26;token=fa215810-e540-422a-a8ae-bc99ca904589" alt="" data-size="original">&#x20;

{% hint style="info" %}
Once the installation is confirmed, the status changes from **waiting** to **downloading**. If you see any failures during the download phase, confirm the path of the installer. If using a network share, ensure that the user credentials entered have the necessary rights to access the share.
{% endhint %}

13\. Confirm that the correct Custom App was installed.

![Confirm Correct Custom App is Installed](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MULS_i-BQKeLV1BoOsQ%2F-MULT1MNR3zwdxmgebna%2Fimage.png?alt=media\&token=f90ae37d-f565-4ac2-a757-430731fee1cf)

14\. The install is complete, click **OK** and return to the Application View. The new application will appear in the list for the computer which you installed it on in the **Custom Apps** column. Click the **Custom Apps** **column header** to expand the list of Custom Apps installed.

![Custom App Installed in the Custom Apps Column](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MVOZkpUVh_bjdNPmfpT%2F-MVObvDo7tSckookcf3P%2Fimage.png?alt=media\&token=72372dc3-55b8-4244-9815-cb803064e927)

15\. The Custom App that you just installed will appear here; **Defraggler** in this example, the version number will appear of the installed Custom App alongside the computer(s) on which it is installed.

![](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MVOZkpUVh_bjdNPmfpT%2F-MVOdY9M_FLtg_xAh9qd%2Fimage.png?alt=media\&token=6e2494c0-5505-4583-a82c-42174490ecea)

{% hint style="success" %}
The Custom App install is complete. The Custom App will now appear in the Applications Grid under the Custom Apps column header.&#x20;

It will now also be available as an App Preset; refer to [Install a Pre-Defined Group of Applications (App Presets)](https://docs.faronics.com/faronicsdeploy/application-management/install-uninstall-and-update-apps/install-application-s/install-a-pre-defined-group-of-applications-app-presets).

To install an application on a group of computers, refer to [Install an Application on a Group of Computers](https://docs.faronics.com/faronicsdeploy/application-management/install-uninstall-and-update-apps/install-application-s/mass-installs-on-a-group).
{% 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/install-uninstall-and-update-apps/install-application-s/install-external-application-s-custom-app/create-and-install-a-custom-app.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.
