# App Installation Issues

> Diagnose and resolve common iOS app installation issues like stuck downloads, greyed-out icons, and integrity verification failures. Get your apps installed!

Source: https://docs.applivery.com/en/app-distribution/troubleshooting/unable-to-download-install-application/  •  Last updated: 2026-06-09

**Key topics:** Network connectivity issues, Provisioning profile problems, Signing certificate issues, Code signature verification failures, iOS, Applivery, Apple Developer Portal, Xcode, UDID

---

**TL;DR:** Fix common iOS app installation problems by checking network connectivity, provisioning profiles, signing certificates, and device UDIDs.

![unable to install](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/92554d69-31a0-4b97-b3ff-b5298dbd6f85.png)
:::info
The issues described here are specific to **iOS**. Android installation problems are typically caused by the "Unknown sources" setting — see [Unknown sources in Android](https://docs.applivery.com/en/app-distribution/platforms/android/unknown-sources/) for guidance.
:::

* * *

## Quick diagnosis: what are you seeing?

| Symptom | Most likely cause |
| --- | --- |
| Progress bar appears but doesn't move | Network connectivity issue |
| App install stuck on "Waiting…" | Network connectivity issue |
| App icon turns dark grey and is not tappable | Certificate or provisioning profile problem |
| Alert: _"Unable To Install — integrity could not be verified"_ | Code signature failure |

* * *

## Progress bar appears but doesn't move

**Cause:** The Device cannot reach Applivery's download servers. This is almost always a network issue.

**Resolution:**

1.  Make sure the Device has a stable internet connection — switch between Wi-Fi and mobile data to rule out a connection-specific problem.
    
2.  Cancel the download and try again.
    
3.  If the issue persists, try on a different network.
    

* * *

## App install stuck on "Waiting…"

**Cause:** iOS queued the installation but cannot proceed — most commonly a network timeout during the download, or an overloaded device state.

**Resolution:**

1.  Make sure the Device has a stable internet connection and try again.
    
2.  If the problem persists, power the Device off completely, wait at least 5 minutes, power it back on, and retry.
    
3.  If it still gets stuck, use the [iOS installation debugger](https://docs.applivery.com/en/app-distribution/platforms/apple/bedug-ios-app-installation/) to capture more details about where the process is failing.
    

* * *

## App icon turns dark grey and is not tappable

This symptom means iOS started the installation but stopped before completing it. The cause is always related to the App's signing configuration. Work through the following checks:

### Missing device UDID (Ad-hoc distribution only)

If the App was signed with an **Ad-hoc** certificate, the Device's UDID must be listed in the provisioning profile. If it isn't, iOS will silently fail to install.

**Resolution:**

1.  In the Applivery Dashboard, open the Build details and note the Device's UDID.
    
2.  Add the UDID to your provisioning profile in the [Apple Developer Portal](https://developer.apple.com/account/).
    
3.  Download the updated provisioning profile, re-sign the App, and upload the new Build to Applivery.
    

### Expired provisioning profile

Provisioning profiles have a maximum validity of one year. An expired profile will prevent installation even if the signing certificate is still valid.

**Resolution:**

1.  Renew the provisioning profile in the [Apple Developer Portal](https://developer.apple.com/account/).
    
2.  Rebuild the App with the updated profile and upload the new Build to Applivery.
    

### Expired signing certificate

Both Ad-hoc and Enterprise signing certificates expire. An expired certificate invalidates all Builds signed with it, even if the provisioning profile is still valid.

**Resolution:**

1.  Renew or create a new signing certificate in the [Apple Developer Portal](https://developer.apple.com/account/).
    
2.  Update your Xcode signing configuration, rebuild the App, and upload the new Build to Applivery.
    

### Other signing issues

If none of the above applies, there may be a mismatch between the certificate, profile, and bundle identifier.

**Resolution:**

1.  Verify that the bundle identifier in your Xcode project matches the one in the provisioning profile exactly.
    
2.  Check that the certificate used to sign the Build is the one associated with the provisioning profile.
    
3.  Use the [iOS installation debugger](https://docs.applivery.com/en/app-distribution/platforms/apple/bedug-ios-app-installation/) to capture the specific error.
    

* * *

## Alert: _"Unable To Install — integrity could not be verified"_

**Full message:** _Unable To Install "App Name": This App cannot be installed because its integrity could not be verified._

**Cause:** Apple checked the App's code signature after download and found it invalid. This typically means the provisioning profile embedded in the App does not match the signing certificate, or the profile has expired.

**Resolution:**

1.  Check the provisioning profile associated with the Build — ensure it is not expired and matches the signing certificate used.
    
2.  Rebuild the App with a valid profile and certificate combination and upload the new Build to Applivery.
    
3.  If the problem persists, use the [iOS installation debugger](https://docs.applivery.com/en/app-distribution/platforms/apple/bedug-ios-app-installation/) to capture the exact failure point.
