Troubleshooting

When something fails

Every error IPAForge shows has a code. Search for it, or for the words on your screen, to see what it means and how to fix it.

86 errors

Unlock your device

device.lockediPhone or iPad

The device is locked, so IPAForge can't talk to it. Unlock it and keep it unlocked until the install finishes.

Link to this error

Developer Mode is off

device.developer_mode_offiPhone or iPad

Sideloaded apps need Developer Mode. Turn it on in Settings › Privacy & Security › Developer Mode, then restart the device.

Link to this error

This computer isn't trusted yet

device.not_pairediPhone or iPad

Unlock the device and tap Trust when it asks whether to trust this computer.

Link to this error

Device support isn't running

device.usbmuxd_unavailableiPhone or iPad

IPAForge can't reach the system service that talks to iPhones and iPads. Install or start it, then try again.

Link to this error

No device found

device.not_foundiPhone or iPad

Connect your iPhone or iPad with a USB cable and unlock it.

Link to this error

The device was disconnected

device.disconnectediPhone or iPad

The connection dropped. Reconnect the cable, unlock the device and try again.

Link to this error

Waiting for Trust

device.pairing_pendingiPhone or iPad

Unlock the device and tap Trust on the prompt that appeared.

Link to this error

Trust was declined

device.pairing_deniediPhone or iPad

The device declined to trust this computer. Pair again and tap Trust this time.

Link to this error

The pairing is no longer valid

device.invalid_pair_recordiPhone or iPad

The device no longer accepts this computer's pairing. Unplug it, plug it back in, unlock it and tap Trust.

Link to this error

A device service didn't start

device.service_unavailableiPhone or iPad

The device refused to start a service IPAForge needs. Unlock it, reconnect it and try again.

Link to this error

Unexpected answer from the device

device.protocol_erroriPhone or iPad

The device sent something IPAForge didn't understand. Reconnect it; if it happens again, update IPAForge or report it.

Link to this error

The install failed

device.install_failediPhone or iPad

The device refused to install the app. Try again; if it keeps failing, reinstall the app or report it.

Link to this error

Couldn't transfer files

device.afc_erroriPhone or iPad

Copying files to the device failed. Unlock it and try again.

Link to this error

The device stopped responding

device.timeoutiPhone or iPad

The device took too long to answer. Unlock it, reconnect it and try again.

Link to this error

Set a passcode

device.passcode_requirediPhone or iPad

This needs a device passcode. Set one in Settings › Face ID & Passcode, then try again.

Link to this error

Too many sideloaded apps

device.free_app_limitiPhone or iPad

A free Apple ID can have only three sideloaded apps active on a device. Remove one, then try again.

Link to this error

Apple blocked this Apple ID on the device

device.profile_bannediPhone or iPad

The device won't accept apps signed with this Apple ID. Retrying won't help: use another Apple ID.

Link to this error

The signing certificate is no longer valid

device.identity_invalidiPhone or iPad

The device rejected the certificate the app was signed with. Check the computer's clock, or revoke the certificate and try again.

Link to this error

Provisioning profile missing

device.profile_not_foundiPhone or iPad

The device couldn't find the app's provisioning profile. Try again, or reinstall the app.

Link to this error

The anisette server isn't responding

apple.anisette_unavailableApple ID

Signing in to Apple needs an anisette server, and the current one didn't answer. Choose another server or check your network.

Link to this error

The anisette server isn't ready

apple.anisette_not_provisionedApple ID

The anisette server couldn't set itself up. Choose another server and try again.

Link to this error

No App IDs left this week

apple.app_id_quotaApple ID

A free Apple ID can register only 10 App IDs every 7 days. Wait for a slot to free up, or use another Apple ID.

Link to this error

Too many certificates

apple.certificate_limitApple ID

This Apple ID has reached its limit of development certificates. Revoke one, or use another Apple ID.

Link to this error

Wrong Apple ID or password

apple.invalid_credentialsApple ID

Apple didn't accept the email or password. Check them and enter the password again.

Link to this error

This Apple ID is locked

apple.account_lockedApple ID

Apple locked this account for security reasons. Unlock it on an Apple device or at Apple's website, or use another Apple ID.

Link to this error

Apple refused the sign-in

apple.account_refusedApple ID

Apple won't let this Apple ID sign in from here right now. Wait a while, sign in once on an Apple device, or use another Apple ID.

Link to this error

Apple rejected the sign-in request

apple.client_rejectedApple ID

Apple didn't accept the identity sent with the sign-in. Choose another anisette server, or wait and try again.

Link to this error

Too many requests

apple.rate_limitedApple ID

Apple is limiting requests for now. Wait a few minutes and try again.

Link to this error

Apple's servers are unavailable

apple.service_unavailableApple ID

Apple's servers didn't respond. Wait a few minutes and check your network.

Link to this error

Enter the verification code

apple.two_factor_requiredApple ID

Apple sent a verification code to your trusted devices. Enter it to continue.

Link to this error

Wrong verification code

apple.two_factor_invalid_codeApple ID

That code didn't work. Check it and enter it again.

Link to this error

This sign-in method isn't supported

apple.two_factor_unsupportedApple ID

This Apple ID uses a two-factor method IPAForge can't handle yet, such as a security key. Use another Apple ID.

Link to this error

Codes by text message aren't available

apple.sms_unavailableApple ID

Apple won't send the code by text message here. Get it on a trusted device, or use another Apple ID.

Link to this error

The computer's clock is wrong

apple.clock_skewApple ID

Apple rejects requests when the clock is off. Set the date and time automatically, then try again.

Link to this error

Unexpected answer from Apple

apple.protocol_errorApple ID

Apple sent something IPAForge didn't understand. Update IPAForge, or report it if it keeps happening.

Link to this error

Your session expired

apple.session_expiredApple ID

Sign in to this Apple ID again. If it keeps expiring, check the computer's clock.

Link to this error

Apple ID not found

apple.account_not_foundApple ID

IPAForge has no saved session for this Apple ID. Sign in again.

Link to this error

This Apple ID can't be used for development

apple.not_eligibleApple ID

Apple doesn't allow this account to sign apps, for example because of its age or terms. Use another Apple ID.

Link to this error

Verify your email

apple.email_unverifiedApple ID

Apple needs this Apple ID's email address verified first. Verify it, then try again.

Link to this error

Accept Apple's agreement

apple.team_agreementApple ID

The team hasn't accepted Apple's latest developer agreement. Accept it at Apple's developer website, or choose another team.

Link to this error

No developer team

apple.no_teamsApple ID

This Apple ID has no developer team yet. Accept Apple's developer agreement, or use another Apple ID.

Link to this error

Device limit reached

apple.device_limitApple ID

This team can't register any more devices. Choose another team, or use another Apple ID.

Link to this error

This App ID is taken

apple.app_id_unavailableApple ID

Another team already uses this App ID. Choose another team, or use another Apple ID.

Link to this error

Apple rejected the App ID name

apple.invalid_app_id_nameApple ID

Apple didn't accept the name IPAForge chose for the App ID. Update IPAForge, or report it.

Link to this error

This certificate can't be revoked here

apple.certificate_not_revocableApple ID

Only Apple can revoke this certificate. Revoke a different one instead.

Link to this error

The device isn't registered yet

apple.no_devices_for_profileApple ID

Apple hasn't finished registering the device. Wait a minute and try again.

Link to this error

Apple's developer services failed

apple.developer_request_failedApple ID

A request to Apple's developer services failed. Try again, and report it if it keeps happening.

Link to this error

The release is no longer available

catalog.source_goneDownloads and sources

The place this app was downloaded from is gone. Choose another channel, import an IPA, or update IPAForge.

Link to this error

Couldn't load the app list

catalog.unavailableDownloads and sources

IPAForge couldn't fetch the list of apps. Check your network and try again.

Link to this error

The download failed

catalog.download_failedDownloads and sources

The app couldn't be downloaded. Check your network and try again.

Link to this error

The download is damaged

catalog.checksum_mismatchDownloads and sources

The downloaded file doesn't match its checksum, so it wasn't used. Try again or choose another channel.

Link to this error

The download can't be verified

catalog.checksum_missingDownloads and sources

This release has no checksum, so IPAForge can't check it. Choose another channel, or import the IPA yourself.

Link to this error

Too many requests to GitHub

catalog.rate_limitedDownloads and sources

GitHub is limiting downloads for now. Wait a few minutes and try again.

Link to this error

Couldn't reach this source

catalog.app_source_unreachableDownloads and sources

Check the link, and that you're online, then try again.

Link to this error

This link isn't an app source

catalog.app_source_invalidDownloads and sources

It doesn't list any apps in the AltStore format. Check the link, or add the app's .ipa file instead.

Link to this error

This source is already added

catalog.app_source_existsDownloads and sources

Its apps are in Browse apps already.

Link to this error

The app's settings file is damaged

plist.invalidThe app

A property list inside the app couldn't be read. Choose another IPA, or report it.

Link to this error

You're offline

net.offlineNetwork

IPAForge can't reach the internet. Check your network connection and try again.

Link to this error

The app's program is damaged

signer.invalid_machoThe app

The app's executable couldn't be read. Choose another IPA.

Link to this error

The app is encrypted

signer.encrypted_binaryThe app

This IPA comes from the App Store and is still encrypted, so it can't be re-signed. Choose a decrypted IPA.

Link to this error

Unsupported app format

signer.unsupported_archThe app

The app's executable uses a format iOS can't run. Choose another IPA.

Link to this error

Needs a newer iOS

signer.unsupported_iosThe app

This app needs a newer iOS version than the device has. Update the device, or choose another channel or IPA.

Link to this error

Not made for this device

signer.unsupported_deviceThe app

This app doesn't support this kind of device, for example an iPad-only app on an iPhone. Choose another IPA.

Link to this error

No build for iPhone or iPad

signer.no_arm64_buildThe app

The app has no 64-bit build for iPhone or iPad, for example a 32-bit or simulator build. Choose another IPA.

Link to this error

The app can't be signed

signer.no_header_spaceThe app

There's no room in the app's executable for a signature. Choose another IPA, or report it.

Link to this error

The IPA is unsafe

signer.zip_slipThe app

The IPA tries to write files outside its own folder, so IPAForge refused it. Choose another IPA.

Link to this error

The certificate is invalid

signer.invalid_certificateThe app

The signing certificate couldn't be used. Revoke it so IPAForge can create a new one, then try again.

Link to this error

Unknown certificate issuer

signer.unknown_issuerThe app

IPAForge doesn't recognise who issued the certificate. Update IPAForge and check your network.

Link to this error

The app bundle is invalid

signer.invalid_bundleThe app

The IPA doesn't contain a valid app. Choose another IPA.

Link to this error

The provisioning profile is invalid

signer.invalid_profileThe app

The provisioning profile from Apple couldn't be read. Try again, and report it if it keeps happening.

Link to this error

An app extension has the wrong ID

signer.extension_prefixThe app

An extension's bundle ID doesn't start with the app's own ID. Choose another IPA.

Link to this error

The provisioning profile doesn't match

signer.profile_mismatchThe app

The profile doesn't match the app it was made for. Try again, and report it if it keeps happening.

Link to this error

The provisioning profile expired

signer.profile_expiredThe app

The profile has expired, or the computer's clock is wrong. Check the clock and try again.

Link to this error

The certificate isn't in the profile

signer.cert_not_in_profileThe app

The provisioning profile doesn't include the signing certificate. Try again to get a fresh profile.

Link to this error

The device isn't in the profile

signer.device_not_provisionedThe app

The provisioning profile doesn't include this device. Try again to get a fresh profile.

Link to this error

A step failed

installer.step_failedInstalling

Something went wrong during the install. Try again, and report it if it keeps happening.

Link to this error

Cancelled

installer.prompt_cancelledInstalling

The install stopped because a question was cancelled. Start again when you're ready.

Link to this error

The certificate can't be shared

installer.certificate_machine_id_missingInstalling

This certificate lacks the data SideStore needs to open it. Revoke it so IPAForge can create a new one, then try again.

Link to this error

Choose a team

installer.team_requiredInstalling

This Apple ID belongs to several teams. Choose the one to sign with.

Link to this error

This app can't be refreshed here

installer.kept_ipa_missingInstalling

IPAForge didn't install it on this device, or its kept copy is gone. Add its .ipa in Preload to install it again.

Link to this error

This link gives a different app

installer.wrong_appInstalling

It isn't the app you're refreshing or updating, so it wasn't installed and the app and its data stay as they are. Add the right .ipa in Preload to install it again.

Link to this error

Internal communication error

rpc.invalid_messageIPAForge itself

Parts of IPAForge couldn't understand each other. Update IPAForge, or report it.

Link to this error

Lost connection to the engine

rpc.disconnectedIPAForge itself

IPAForge's engine stopped responding. Try again, and report it if it keeps happening.

Link to this error

The engine didn't answer

rpc.timeoutIPAForge itself

IPAForge's engine took too long to answer. Try again, and report it if it keeps happening.

Link to this error

Stopped

internal.abortedIPAForge itself

The operation was stopped before it finished.

Link to this error

Something went wrong

internal.unexpectedIPAForge itself

An unexpected error happened. Try again, and report it if it keeps happening.

Link to this error
Made from packages/ui/src/locales/en.json in the IPAForge repository. Edit this page on GitHub Report a problem