# General Custom Apps Troubleshooting

*Applies to: Patch My PC (PMPC) Cloud Custom Apps*

If issues arise when deploy apps using Patch My PC (PMPC) Cloud Custom App deployments, please follow these initial troubleshooting steps:

* [Review Custom Apps Reference](#review-custom-apps-reference)
* [Check Installation Commands](#check-installation-commands)
* [Review the Considerations when using Custom Apps](#considerations)
* [Consult our List of Common Installation Switches](#list-of-common-installation-switches)
* [Test Locally](#test-locally)
* [Additional Troubleshooting Steps](#additional-troubleshooting-steps)

Please also consider the following when using the Custom Apps feature:

* [Support Limitations](#support-limitations)

### **Review Custom Apps Reference:**

Please review the [Custom Apps Reference](https://docs.patchmypc.com/installation-guides/patch-my-pc-cloud/custom-apps/custom-apps-reference) section.

### **Check Installation Commands:**

Verify you are using the correct commands, switches, and parameters:

* Consult vendor installation guides
* Review knowledge base or deployment documentation
* Resources:
  * [Silent Install HQ](https://silentinstallhq.com/)
  * [IT Ninja](https://www.itninja.com/)
  * [App Deploy News](https://appdeploynews.com/) 
* Try running the installer with the following common switches for guidance:\
   `/?`, `-?`, `/h`, or `--help` 
* Extract the installer files to locate their documentation.
* Search vendor forums/support sites using "**command line**" terms.

### Considerations

* Apps must support silent install
* Per-user MSI’s are not currently supported
* Not all newer version of applications will automatically remove the existing version. Consider using the Patch My PC [Uninstall-Software.ps1](https://github.com/PatchMyPCTeam/Community-Scripts/tree/main/Uninstall/Pre-Uninstall/Uninstall-Software) community script as a [Pre-Install Script](/patch-my-pc-cloud/deployments/deploy-app/configurations-tab/additional-tools/scripts.md#pre-install-script) in that scenario
* Putting the Architecture in the **DisplayName** forces detection to look in the **64bit Uninstall ARP** key - example: **x64** or **64bit** or **64-bit**
* Apps need a valid **DisplayVersion** for detection. For example, **1.00-00e.2** is not a valid version number
* Test the app installs okay as the **SYSTEM** user using [PsExec](https://learn.microsoft.com/en-us/sysinternals/downloads/psexec). Intune will install apps in the **SYSTEM** context and this may affect installation and/or detection.

### **List of Common Installation Switches**

| Installer Technology | Silent/Quiet Install                 | Prevent Reboot                          |
| -------------------- | ------------------------------------ | --------------------------------------- |
| MSI                  | `/quiet` or `/q` or `/qn`            | `/norestart` or `REBOOT=ReallySuppress` |
| NSIS (Nullsoft)      | `/S` (case sensitive!)               |                                         |
| Inno Setup           | `/SP- /VERYSILENT /SUPPRESSMSGBOXES` | `/NORESTART`                            |
| InstallShield        | `/s` or `/s` or `/SMS`               |                                         |

### **Test Locally**

Use a checklist similar to that below, before deploying via PMPC Cloud to thoroughly test installations locally:

<table><thead><tr><th width="295">Test Case</th><th width="67">Pass</th><th width="56">Fail</th><th width="282">Notes</th></tr></thead><tbody><tr><td>Manual Installation</td><td>✔️</td><td></td><td> </td></tr><tr><td>Manual Uninstallation</td><td></td><td>❌</td><td> </td></tr><tr><td>User Prompt Verification</td><td></td><td></td><td>List prompts encountered</td></tr><tr><td>Silent Installation (/quiet /noreboot)</td><td></td><td></td><td> </td></tr><tr><td>Custom Pre-Installation Scripts</td><td></td><td></td><td> </td></tr><tr><td>Custom Post-Installation Scripts</td><td></td><td></td><td> </td></tr><tr><td>Application Launch After Install</td><td></td><td></td><td> </td></tr><tr><td>Installation on Clean System</td><td></td><td></td><td> </td></tr><tr><td>Installation over Previous Version</td><td></td><td></td><td> </td></tr><tr><td>Logging Verification</td><td></td><td></td><td> </td></tr><tr><td>Disk Space Requirements Check</td><td></td><td></td><td> </td></tr><tr><td>System Restart Behavior</td><td></td><td></td><td> </td></tr><tr><td>Installed as SYSTEM using psexec</td><td></td><td></td><td></td></tr></tbody></table>

### &#x20;**Additional Troubleshooting Steps**

* **Review Logs:** Examine vendor-specific logs for detailed error messages
* **Simplify Installation:** Divide complex installations into simpler steps to isolate issues.

### **Support Limitations**

As detailed in our [Custom Apps Support Statement](https://patchmypc.com/custom-apps-support-statement), full deployment support for every custom application cannot be assured. Some applications may:

* Use proprietary or unusual installation methods
* Require specific environmental configurations
* Need specialized knowledge from the vendor
* Employ installation technologies incompatible with our service.

#### &#x20;**Our Support Team Can Help With:**

* Initial setup of the Custom Apps feature
* Successful uploads of Custom Apps
* Verification that apps appear correctly for publishing in Patch My PC Publisher
* Uploading applications to the Custom Apps portal
* Connecting to the Patch My PC Publisher
* Resolving login and user invitation issues within the Custom Apps portal
* Addressing errors related to Custom Apps appearing in PatchMyPC.log or the Custom Apps UI.

#### **"Best-Effort" Support Offered for Custom Apps that fail:**

* Installation on devices
* To be detected post-installation.

#### **Our Support Team Cannot:**

* Guarantee packaging success for every application through the Custom Apps feature
* Create Custom Apps on behalf of customers
* Write custom scripts to facilitate app installations.

### **Getting Support**

Our team will support you within our capabilities, as outlined above.&#x20;

But, for highly specialized or complex apps, complete solutions may not always be possible. If an app issue falls beyond our scope, consider consulting directly with the application vendor.

To submit a support case concerning Custom Apps you, [Open a Support Case](https://patchmypc.com/technical-support) and choose “**Custom Apps**” as the product.


---

# 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/troubleshoot/custom-apps/general-custom-apps-troubleshooting.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.