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 iPadThe device is locked, so IPAForge can't talk to it. Unlock it and keep it unlocked until the install finishes.
Link to this errorDeveloper Mode is off
device.developer_mode_offiPhone or iPadSideloaded apps need Developer Mode. Turn it on in Settings › Privacy & Security › Developer Mode, then restart the device.
Link to this errorThis computer isn't trusted yet
device.not_pairediPhone or iPadUnlock the device and tap Trust when it asks whether to trust this computer.
Link to this errorNo device found
device.not_foundiPhone or iPadConnect your iPhone or iPad with a USB cable and unlock it.
Link to this errorThe device was disconnected
device.disconnectediPhone or iPadThe connection dropped. Reconnect the cable, unlock the device and try again.
Link to this errorWaiting for Trust
device.pairing_pendingiPhone or iPadUnlock the device and tap Trust on the prompt that appeared.
Link to this errorTrust was declined
device.pairing_deniediPhone or iPadThe device declined to trust this computer. Pair again and tap Trust this time.
Link to this errorThe pairing is no longer valid
device.invalid_pair_recordiPhone or iPadThe device no longer accepts this computer's pairing. Unplug it, plug it back in, unlock it and tap Trust.
Link to this errorUnexpected answer from the device
device.protocol_erroriPhone or iPadThe device sent something IPAForge didn't understand. Reconnect it; if it happens again, update IPAForge or report it.
Link to this errorThe install failed
device.install_failediPhone or iPadThe device refused to install the app. Try again; if it keeps failing, reinstall the app or report it.
Link to this errorCouldn't transfer files
device.afc_erroriPhone or iPadCopying files to the device failed. Unlock it and try again.
Link to this errorThe device stopped responding
device.timeoutiPhone or iPadThe device took too long to answer. Unlock it, reconnect it and try again.
Link to this errorSet a passcode
device.passcode_requirediPhone or iPadThis needs a device passcode. Set one in Settings › Face ID & Passcode, then try again.
Link to this errorToo many sideloaded apps
device.free_app_limitiPhone or iPadA free Apple ID can have only three sideloaded apps active on a device. Remove one, then try again.
Link to this errorApple blocked this Apple ID on the device
device.profile_bannediPhone or iPadThe device won't accept apps signed with this Apple ID. Retrying won't help: use another Apple ID.
Link to this errorThe signing certificate is no longer valid
device.identity_invalidiPhone or iPadThe device rejected the certificate the app was signed with. Check the computer's clock, or revoke the certificate and try again.
Link to this errorProvisioning profile missing
device.profile_not_foundiPhone or iPadThe device couldn't find the app's provisioning profile. Try again, or reinstall the app.
Link to this errorThe anisette server isn't ready
apple.anisette_not_provisionedApple IDThe anisette server couldn't set itself up. Choose another server and try again.
Link to this errorNo App IDs left this week
apple.app_id_quotaApple IDA 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 errorToo many certificates
apple.certificate_limitApple IDThis Apple ID has reached its limit of development certificates. Revoke one, or use another Apple ID.
Link to this errorWrong Apple ID or password
apple.invalid_credentialsApple IDApple didn't accept the email or password. Check them and enter the password again.
Link to this errorThis Apple ID is locked
apple.account_lockedApple IDApple 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 errorApple refused the sign-in
apple.account_refusedApple IDApple 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 errorApple rejected the sign-in request
apple.client_rejectedApple IDApple didn't accept the identity sent with the sign-in. Choose another anisette server, or wait and try again.
Link to this errorToo many requests
apple.rate_limitedApple IDApple is limiting requests for now. Wait a few minutes and try again.
Link to this errorEnter the verification code
apple.two_factor_requiredApple IDApple sent a verification code to your trusted devices. Enter it to continue.
Link to this errorWrong verification code
apple.two_factor_invalid_codeApple IDThat code didn't work. Check it and enter it again.
Link to this errorThis sign-in method isn't supported
apple.two_factor_unsupportedApple IDThis Apple ID uses a two-factor method IPAForge can't handle yet, such as a security key. Use another Apple ID.
Link to this errorThe computer's clock is wrong
apple.clock_skewApple IDApple rejects requests when the clock is off. Set the date and time automatically, then try again.
Link to this errorUnexpected answer from Apple
apple.protocol_errorApple IDApple sent something IPAForge didn't understand. Update IPAForge, or report it if it keeps happening.
Link to this errorYour session expired
apple.session_expiredApple IDSign in to this Apple ID again. If it keeps expiring, check the computer's clock.
Link to this errorApple ID not found
apple.account_not_foundApple IDIPAForge has no saved session for this Apple ID. Sign in again.
Link to this errorThis Apple ID can't be used for development
apple.not_eligibleApple IDApple doesn't allow this account to sign apps, for example because of its age or terms. Use another Apple ID.
Link to this errorVerify your email
apple.email_unverifiedApple IDApple needs this Apple ID's email address verified first. Verify it, then try again.
Link to this errorAccept Apple's agreement
apple.team_agreementApple IDThe team hasn't accepted Apple's latest developer agreement. Accept it at Apple's developer website, or choose another team.
Link to this errorNo developer team
apple.no_teamsApple IDThis Apple ID has no developer team yet. Accept Apple's developer agreement, or use another Apple ID.
Link to this errorDevice limit reached
apple.device_limitApple IDThis team can't register any more devices. Choose another team, or use another Apple ID.
Link to this errorApple rejected the App ID name
apple.invalid_app_id_nameApple IDApple didn't accept the name IPAForge chose for the App ID. Update IPAForge, or report it.
Link to this errorThis certificate can't be revoked here
apple.certificate_not_revocableApple IDOnly Apple can revoke this certificate. Revoke a different one instead.
Link to this errorThe device isn't registered yet
apple.no_devices_for_profileApple IDApple hasn't finished registering the device. Wait a minute and try again.
Link to this errorApple's developer services failed
apple.developer_request_failedApple IDA request to Apple's developer services failed. Try again, and report it if it keeps happening.
Link to this errorThe release is no longer available
catalog.source_goneDownloads and sourcesThe place this app was downloaded from is gone. Choose another channel, import an IPA, or update IPAForge.
Link to this errorThe download failed
catalog.download_failedDownloads and sourcesThe app couldn't be downloaded. Check your network and try again.
Link to this errorThe download is damaged
catalog.checksum_mismatchDownloads and sourcesThe downloaded file doesn't match its checksum, so it wasn't used. Try again or choose another channel.
Link to this errorThe download can't be verified
catalog.checksum_missingDownloads and sourcesThis release has no checksum, so IPAForge can't check it. Choose another channel, or import the IPA yourself.
Link to this errorToo many requests to GitHub
catalog.rate_limitedDownloads and sourcesGitHub is limiting downloads for now. Wait a few minutes and try again.
Link to this errorCouldn't reach this source
catalog.app_source_unreachableDownloads and sourcesCheck the link, and that you're online, then try again.
Link to this errorThis link isn't an app source
catalog.app_source_invalidDownloads and sourcesIt doesn't list any apps in the AltStore format. Check the link, or add the app's .ipa file instead.
Link to this errorThis source is already added
catalog.app_source_existsDownloads and sourcesIts apps are in Browse apps already.
Link to this errorThe app's settings file is damaged
plist.invalidThe appA property list inside the app couldn't be read. Choose another IPA, or report it.
Link to this errorYou're offline
net.offlineNetworkIPAForge can't reach the internet. Check your network connection and try again.
Link to this errorThe app's program is damaged
signer.invalid_machoThe appThe app's executable couldn't be read. Choose another IPA.
Link to this errorThe app is encrypted
signer.encrypted_binaryThe appThis IPA comes from the App Store and is still encrypted, so it can't be re-signed. Choose a decrypted IPA.
Link to this errorUnsupported app format
signer.unsupported_archThe appThe app's executable uses a format iOS can't run. Choose another IPA.
Link to this errorNeeds a newer iOS
signer.unsupported_iosThe appThis app needs a newer iOS version than the device has. Update the device, or choose another channel or IPA.
Link to this errorNot made for this device
signer.unsupported_deviceThe appThis app doesn't support this kind of device, for example an iPad-only app on an iPhone. Choose another IPA.
Link to this errorNo build for iPhone or iPad
signer.no_arm64_buildThe appThe app has no 64-bit build for iPhone or iPad, for example a 32-bit or simulator build. Choose another IPA.
Link to this errorThe app can't be signed
signer.no_header_spaceThe appThere's no room in the app's executable for a signature. Choose another IPA, or report it.
Link to this errorThe IPA is unsafe
signer.zip_slipThe appThe IPA tries to write files outside its own folder, so IPAForge refused it. Choose another IPA.
Link to this errorThe certificate is invalid
signer.invalid_certificateThe appThe signing certificate couldn't be used. Revoke it so IPAForge can create a new one, then try again.
Link to this errorUnknown certificate issuer
signer.unknown_issuerThe appIPAForge doesn't recognise who issued the certificate. Update IPAForge and check your network.
Link to this errorThe app bundle is invalid
signer.invalid_bundleThe appThe IPA doesn't contain a valid app. Choose another IPA.
Link to this errorThe provisioning profile is invalid
signer.invalid_profileThe appThe provisioning profile from Apple couldn't be read. Try again, and report it if it keeps happening.
Link to this errorAn app extension has the wrong ID
signer.extension_prefixThe appAn extension's bundle ID doesn't start with the app's own ID. Choose another IPA.
Link to this errorThe provisioning profile doesn't match
signer.profile_mismatchThe appThe profile doesn't match the app it was made for. Try again, and report it if it keeps happening.
Link to this errorThe provisioning profile expired
signer.profile_expiredThe appThe profile has expired, or the computer's clock is wrong. Check the clock and try again.
Link to this errorThe certificate isn't in the profile
signer.cert_not_in_profileThe appThe provisioning profile doesn't include the signing certificate. Try again to get a fresh profile.
Link to this errorThe device isn't in the profile
signer.device_not_provisionedThe appThe provisioning profile doesn't include this device. Try again to get a fresh profile.
Link to this errorA step failed
installer.step_failedInstallingSomething went wrong during the install. Try again, and report it if it keeps happening.
Link to this errorCancelled
installer.prompt_cancelledInstallingThe install stopped because a question was cancelled. Start again when you're ready.
Link to this errorThe certificate can't be shared
installer.certificate_machine_id_missingInstallingThis certificate lacks the data SideStore needs to open it. Revoke it so IPAForge can create a new one, then try again.
Link to this errorChoose a team
installer.team_requiredInstallingThis Apple ID belongs to several teams. Choose the one to sign with.
Link to this errorThis app can't be refreshed here
installer.kept_ipa_missingInstallingIPAForge 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 errorThis link gives a different app
installer.wrong_appInstallingIt 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 errorInternal communication error
rpc.invalid_messageIPAForge itselfParts of IPAForge couldn't understand each other. Update IPAForge, or report it.
Link to this errorLost connection to the engine
rpc.disconnectedIPAForge itselfIPAForge's engine stopped responding. Try again, and report it if it keeps happening.
Link to this errorThe engine didn't answer
rpc.timeoutIPAForge itselfIPAForge's engine took too long to answer. Try again, and report it if it keeps happening.
Link to this errorStopped
internal.abortedIPAForge itselfThe operation was stopped before it finished.
Link to this errorSomething went wrong
internal.unexpectedIPAForge itselfAn unexpected error happened. Try again, and report it if it keeps happening.
Link to this errorNo error matches. Try fewer words, or ask on Discord.
packages/ui/src/locales/en.json in the IPAForge repository.
Edit this page on GitHub
Report a problem