Troubleshooting iOS Installation Failures

When installing a Pgyer-distributed app on iOS, you may see errors such as Unable to Install, Cannot Verify App, or Installation Failed. This page lists the common causes and fixes.

"Unable to Install", "Cannot Verify", or a Dimmed Icon

This is usually caused by an invalid signature. Common reasons include:

• Certificate expired: The signing certificate is past its expiry date.
• Mismatched provisioning profile: The provisioning profile does not match the bundle identifier or the certificate.
• UDID not registered: For Ad-Hoc distribution, the device's UDID was not added to the provisioning profile.

Try the following first:

1. Check whether the same app is already installed; if so, uninstall it and retry.
2. If that does not help, contact the developer who invited you to resolve the signing issue.

Untrusted Enterprise Developer

For enterprise-distributed apps, you need to trust the certificate after the first install:

1. Go back to the Home Screen and open Settings > General > VPN & Device Management;
2. Tap the relevant profile and choose Trust.

Developer Mode Not Enabled

On iOS 16 and above, you must enable Developer Mode before running an Ad-Hoc build:

1. Open Settings > Privacy & Security;
2. Scroll down and tap Developer Mode;
3. Toggle it on, enter your device passcode, and restart the device.

Once enabled, Ad-Hoc builds install and launch normally.

Incompatible iOS Version

Confirm the minimum iOS version the app targets. If your device runs an older version, upgrade iOS first.

Unstable Network

Installation downloads the package on demand, so connect to a stable Wi-Fi network to avoid incomplete downloads.

Insufficient Storage

Make sure the device has enough free space for the app. Clear files or uninstall unused apps if needed.

Conflict with an Older Version

If an older version is already installed, signing or bundle-identifier conflicts may block the new build. Uninstall the old version and retry.

Device Compatibility

Some apps rely on frameworks or capabilities available only on newer devices. Confirm the device is within the app's supported range.