# Deploy a Binary Free App

*Applies to: Binary Free Apps for Patch My PC Cloud*

There are two stages to deploying a Patch My PC (PMPC) Cloud Binary Free App:

* [Upload the app installer](#upload-the-app-installer)
* [Deploy the Binary Free app](#deploy-the-binary-free-app)

### Upload the app installer

To upload the app installer for the Binary Free App:

1. Download the relevant version of the software from the vendor for the app you wish to deploy.
2. Sign in to the Cloud portal.
3. Search for the app in the **App Catalog**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FaUqA6QYA0bs7Ej1uwyQk%2Fimage.png?alt=media&#x26;token=39336fef-3a76-4cc0-bc6a-e01e7b859b52" alt="Searching for the app in the App Catalog" width="563"><figcaption></figcaption></figure>

4. Click the app to open its properties.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Fdt2EmvV37YRyk3HgYRhX%2Fimage.png?alt=media&#x26;token=7e264675-4162-4885-8517-e349f1ea03ad" alt="Clicking the app to open its properties" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

Notice that both the **Deploy** and **Edit Deployment** options are unavailable, as this is a Binary Free App that requires you to upload the installer.
{% endhint %}

5. Click **Manage Files**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FpRT1UPetWeVC43QwpB5f%2Fimage.png?alt=media&#x26;token=ad617808-8068-40e3-a60d-971a7b57f2be" alt="Clicking “Manage Files” " width="563"><figcaption></figcaption></figure>

6. On the **“<*****app\_name*****>” Upload file** screen, click **Add App File**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FEd6kFmpk2khKanIEPjJX%2Fimage.png?alt=media&#x26;token=ffa9d5e9-9036-4477-bad6-05931c502bce" alt="Clicking “Add App File”" width="563"><figcaption></figcaption></figure>

7. On the **General Information** tab, configure the required options for the app, then click **Next**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F5PIWHCEOg7uWwKO2ftBb%2Fimage.png?alt=media&#x26;token=01041c15-020a-4849-9c87-02f1be8d9ca7" alt="Configuring any required options for the app, then clicking “Next”" width="563"><figcaption></figcaption></figure>

8. On the **Upload File Installer** tab, either:
   1. Click **Add Application File** and browse to the location containing the app’s installer.
   2. Drag and drop the installer file onto this page.

{% hint style="info" %}
**Note**

To help you identify which file you should upload, we populate the **Expected Installer File Name** field with the file name.
{% endhint %}

{% hint style="success" %}
**Tip**

We suggest you use the download link at the bottom of the page to ensure you download the latest version of the app from the vendor’s official website.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F0QlzkImXNZ6VaVAZlifZ%2Fimage.png?alt=media&#x26;token=ad54a0e3-483a-4882-8e8b-5282c065f91e" alt="Clicking “Add Application File”" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

If you select either the wrong file or the wrong version of the file, the [Unable to verify the file you are trying to upload. Please ensure you have uploaded the correct file](https://docs.patchmypc.com/patch-my-pc-cloud/troubleshoot/binary-free-apps/unable-to-verify-the-file-you-are-trying-to-upload-error-in-binary-free-apps) error will be displayed.

This is because we validate the hash of the installer to ensure you are uploading the correct file compared to the version information we have stored in our App Catalog.

If you really need to deploy an older version of the app, deploy it as a Custom App by using the [Create a Custom App](https://docs.patchmypc.com/patch-my-pc-cloud/custom-apps/create-a-custom-app)  process.
{% endhint %}

The hash for the file is calculated as the file is uploaded to your portal.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FettEOtOsxOzzaFVYGnAM%2Fimage.png?alt=media&#x26;token=279c0afd-3cb1-472a-9d55-43a28169df4e" alt="Calculating the hash for the file as its uploaded to your portal." width="563"><figcaption></figcaption></figure>

The portal also shows **File Up to Date** and the **Success – File Successfully Uploaded** notification once:

* The file has been uploaded successfully.
* The calculated hash matches that stored in our App Catalog.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FAl5vWtbdaJh2qk14nyiZ%2Fimage.png?alt=media&#x26;token=346597f0-6611-47dd-a322-38ff01ee6164" alt="“Success – File Successfully Uploaded” notification " width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

By default, whenever a new version of a Binary Free App is released, we update the version in our App Catalog, which will trigger an update notification to be sent to all users configured in your portal.

See the [Manage New Version Notifications for a Binary Free App](https://docs.patchmypc.com/patch-my-pc-cloud/binary-free-apps/manage-new-version-notifications-for-a-binary-free-app) process to change this.
{% endhint %}

### Deploy the Binary Free app

Once the app installer for the Binary Free App has been successfully uploaded, follow the [Deploy an App](https://docs.patchmypc.com/patch-my-pc-cloud/deployments/deploy-app) process to deploy the app.

{% hint style="info" %}
**Note**

If you attempt to deploy a Binary Free App for which you have not uploaded the required installer, you will see the error:\
\
**To deploy this variant (installer type), first obtain the latest version of the installer and upload it via the ‘Manage Files' option...**

![Deployment error when attempting to deploy a Binary Free App for which you have not uploaded the required installer](https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FJclieIuwt2m0KmkSOFKM%2Fimage.png?alt=media\&token=858506b7-0930-4215-b630-e763ee6f2204)

You will need to cancel the deployment and [upload the app installer](#upload-the-app-installer) before you will be able to deploy this app.
{% 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.patchmypc.com/patch-my-pc-cloud/binary-free-apps/deploy-a-binary-free-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.
