description
This page includes a list of various error codes you may receive while using AltStore.

⚠️ Error Codes

AltStore Errors

(1000) An unknown error occurred.

AltStore.OperationError

This means that AltStore ran into an unexpected error. Please check our Troubleshooting Guide, and you can reach out to us directly if the issue persists.

(1001) The operation returned an unknown result.

This means that AltStore ran into an unexpected error. Please check our Troubleshooting Guide, and you can reach out to us directly if the issue persists.

(1002) The operation was cancelled.

AltStore.OperationError

This means that the performed action was stopped. Please try again.

(1003) The operation timed out.

AltStore.OperationError

This means that AltStore ran into problems trying to complete the requested action. Please try again and check our Troubleshooting Guide for additional help. You can reach out to us directly if the issue persists.

(1004) You are not signed in.

AltStore.OperationError

This means that you must enter your Apple ID information in the settings tab to do the requested action.

(1005) The app could not be found.

AltStore.OperationError

This means that AltStore could not locate the file to download or install, most likely because the file does not exist at the provided URL.

(1006) AltStore could not determine this device's UDID.

AltStore.OperationError

This means that AltStore couldn't read the device UDID embedded by AltServer when installing AltStore. Make sure you're installing AltStore with the latest AltServer version and not via another method.

(1007) This app is in an invalid format.

AltStore.OperationError

This means the app you're trying to install is not a standard .ipa. Try downloading the app from another location.

(1008) Invalid parameters.

AltStore.OperationError

This means an internal error occured and AltStore couldn't provide the necessary information to perform the requested task. Please try again and check our Troubleshooting Guide for additional help. You can reach out to us directly if the issue persists.

(1009) You cannot register more than 10 App IDs within a 7 day period.

AltStore.OperationError

This means that you have reached the maximum amount of App IDs available. Please check the App IDs in the My Apps tab to see when they will expire.

(1010) There are no AltStore sources.

AltStore.OperationError

This means an internal error occured and AltStore is unable to fetch changes for any Sources you've added. Please try again and check our Troubleshooting Guide for additional help. You can reach out to us directly if the issue persists.

(1011) AltStore was denied permission to launch the app.

AltStore.OperationError

This means AltStore couldn't launch a sideloaded app because you tapped "Cancel" on the "AltStore wants to open [app]" alert, or because you still need to trust your Apple ID in Settings.

(1012) AltStore's shared app group could not be accessed.

AltStore.OperationError

This means AltStore was not able to access the directory where app backups are stored. Make sure you're installing AltStore with the latest AltServer version and not via another method.

(1200) AltServer could not be found.

AltStore.OperationError

This means that AltStore is having trouble discovering AltServer on your local network. Make sure you're connected to the same WiFi network as your PC/Mac running AltServer, or try connecting your device to your computer via USB.

(1201) A connection to AltServer could not be established.

AltStore.OperationError

This means that AltStore is having trouble connecting to AltServer on your PC/Mac. Make sure you have Wi-Fi sync enabled, and otherwise you may try plugging in your device directly via USB.

(1202) The connection to AltServer was dropped.

AltStore.OperationError

This means that AltStore's connection to AltServer on your PC/Mac was interrupted. Make sure you have Wi-Fi sync enabled, and otherwise you may try plugging in your device directly via USB.

AltServer Errors

(0) Exception Error

AltServer.ExceptionError

This error can appear for many reasons, and below are a few that you might see (this is not an exhaustive list).

"vector too long"

This means that Windows Defender is blocking your request. You may need to first disable Real-Time Protection on Windows in order for AltStore to work as expected.

(1999) Underlying Error

AltServer.ServerError

This means that AltServer ran into an unknown error. We recommend reaching out to our support channels if the issue persists.

(2000) Unknown Error

AltServer.ServerError

This means that AltServer ran into an unknown error. We recommend reaching out to our support channels if the issue persists.

(2001) Could not connect to AltServer. / There was an error connecting to the device.

AltServer.ServerError

This means that AltServer is having trouble connecting to your iOS device. Try plugging your device directly into your computer if it is not already.

If you still have issues, please refer to the Troubleshooting Guide.

(2002) Lost Connection to AltServer.

AltServer.ServerError

This means that the connection was dropped between AltServer and your iOS device. Make sure your device and computer are connected to the same WiFi network and try again.

If you still have issues, please refer to the Troubleshooting Guide.

(2003) AltServer could not find this device.

AltServer.ServerError

This means that AltServer had trouble locating your iOS device either over USB or via WiFi. Make sure your device and computer are connected to the same WiFi network and that your device is trusted and try again.

If you still have issues, please refer to the Troubleshooting Guide.

(2004) Failed to write app data to device.

AltServer.ServerError

This means that AltServer tried to write a file to your device and could not or was interrupted. Make sure your device and computer are connected to the same WiFi network and that your device is trusted and try again.

If you still have issues, please refer to the Troubleshooting Guide.

(2005) AltServer received an invalid request.

AltServer.ServerError

This means that AltServer received a request it did not understand. This may be because you are running an outdated AltServer version, so please make sure to update to the latest version.

(2006) AltServer sent an invalid response.

AltServer.ServerError

This means that AltStore received a response from AltServer it did not understand. This may be because you are running an outdated AltStore version, so please make sure to update to the latest version.

(2007) The app is invalid.

AltServer.ServerError

This means that the app your were attempting to install was found to be in an invalid format. If you continue to have issues, try downloading from alternate source.

(2008) An error occurred while installing the app.

AltServer.ServerError

This means that iOS rejected the app you were attempting to install. Make sure to use a version compatible your iOS version.

(2009) Cannot activate more than 3 apps with a non-developer Apple ID.

AltServer.ServerError

This means that you have reached the maximum amount of sideloaded apps you can have with a Free Developer Account. Apple limits the amount of sideloaded apps you can have with a free account, and to remove the limit you need to sign up for a Paid Developer account at developer.apple.com.

You can also remove this limit if you have a device capable of using the MacDirtyCow exploit

(2010) Your device must be running iOS 12.2 or later to install AltStore.

AltServer.ServerError

This means that you will need to update your phone to the minimum iOS version required before you can continue to use AltStore.

(2011) AltServer does not support this request.

AltServer.ServerError

This means that AltServer received a request it did not recognize. You may be running an outdated AltServer version, so be sure to update.

(2012) Received an unknown response from AltServer.

AltServer.ServerError

This means that AltStore received a response from AltServer it did not recognize. You may be running an outdated AltStore version, so be sure to update.

(2013) The provided anisette data is invalid.

AltServer.ServerError

This means that the Apple ID information AltStore used to try to sign in was invalid because of an unknown issue. Make sure you are using the latest version of iCloud if you are on Windows and that your date/time are accurate.

(2014) AltServer could not connect to Mail plug-in. (macOS)

AltServer.ServerError

This means that AltServer could not find the Mail plug-in either because it is not enable or you are not running the Mail app on your Mac. Make sure the Mail app is running on your Mac and that the plug-in is enabled. For more help, check the Mail Plug-In page in the install guide.

(2015) Could not find provisioning profile.

AltServer.ServerError

This means that the provisioning profile needed to install this app could not be located. This is most likely a problem with AltStore itself, so please message support or to our Patreon inbox.

(2016) An error occurred while removing the app.

AltServer.ServerError

This means that there was an issue while removing an app. There are a number of different issues so make sure to check your error log for a more specific message on your issue.

(2100) The Requested app is not currently running on the device.

AltServer.ServerError

This means that you tried to enable JIT without the requested app running in the foreground. Make sure to launch the app and have it running before you enable JIT.

(2101) The disk is incompatible with [iOS version].

AltServer.ServerError

This means that the developer disk required to enable JIT is not compatible with your device's OS version. Make sure you're running the latest version of AltStore and AltServer, and try again later.