Skip to main content

Error Codes

warning

This page is currently not fully accurate to how SideStore works, as this is based on AltStore's Error Codes page. Some info is still correct, but please don't rely on this word for word. Make sure to ask in our Discord server for help if you need it.

SideStore Errors

(1000) An unknown error occurred.

SideStore.OperationError 1000

This means that SideStore 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.

SideStore.OperationError 1001

This means that SideStore 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.

SideStore.OperationError 1002

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

(1003) The operation timed out.

SideStore.OperationError 1003

This means that SideStore 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.

SideStore.OperationError 1004

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.

SideStore.OperationError 1005

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

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

SideStore.OperationError 1006

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

(1007) This app is in an invalid format.

SideStore.OperationError 1007

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

(1008) Invalid parameters.

SideStore.OperationError 1008

This means an internal error occured and SideStore 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 at our Discord server.

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

SideStore.OperationError 1009

This means that you have reached the maximum amount of App IDs available. Apps IDs are not able to be deleted manually. App IDs renew if the app has exists 7 days after when it was first installed or renewed last, and expire if they have been deleted since. Please check the App IDs in the My Apps tab to see when they will expire.

(1010) There are no AltStore sources.

SideStore.OperationError 1010

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

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

SideStore.OperationError 1011

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

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

SideStore.OperationError 1012

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

(1403) Unable to connect to SideJITServer.

SideStore.OperationError 1403

Please make sure you are on the same Wi-Fi as your computer running SideJITServer and that your Firewall has been set appropriately.

(1412) Unable to connect to a V3 anisette server.

SideStore.OperationError 1412

Your device was unable to recieve data from a V3 anisette server. Please try again, or switch anisette servers.

(1414) No Wi-Fi/StosVPN.

SideStore.OperationError 1414

You do not appear to be connected to Wi-Fi and/or StosVPN. SideStore cannot refresh or install applications without Wi-Fi and StosVPN, ensure both are enabled. If that doesn't work, try regenerating your pairing file.

Minimuxer Errors

(27) AFC was unable to manage files on the device.

minimuxer.MinimuxerError 27

This means you have an invalid pairing file. Follow the steps to regenerate.

More coming, open to contributions...

AltServer / SideServer 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 SideStore 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 Wi-Fi 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 Wi-Fi. Make sure your device and computer are connected to the same Wi-Fi 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 Wi-Fi 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 SideStore received a response from AltServer it did not understand. This may be because you are running an outdated SideStore 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.

(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.

(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.

Apple Developer Errors

(3000) An unknown error occurred.

AltStore.AppleDeveloperError

Updated information coming soon

(3001) The provided parameters are invalid.

AltStore.AppleDeveloperError

Updated information coming soon

(3002) Incorrect Apple ID or password.

AltStore.AppleDeveloperError

This means that the Apple ID credentials you used were invalid. Make sure the username and password are correct.

If you still have issues, you can also try creating a new Apple ID to use with SideStore.

(3003) An app-specific password is required. You can create one at appleid.apple.com.

AltStore.AppleDeveloperError

Updated information coming soon.

(3004) You are not a member of any development teams.

AltStore.AppleDeveloperError

Updated information coming soon.

(3005) This device's UDID is invalid.

AltStore.AppleDeveloperError

Updated information coming soon.

(3006) This device is already registered with another ID.

AltStore.AppleDeveloperError

Updated information coming soon.

(3007) The certificate request is invalid.

AltStore.AppleDeveloperError

Updated information coming soon.

(3008) There is no certificate with the requested serial number for this team.

AltStore.AppleDeveloperError

Updated information coming soon.

(3009) The name for this app is invalid.

AltStore.AppleDeveloperError

SideStore couldn’t register an App ID with Apple because the app name contains non-ASCII characters. You can try downloading from another source.

(3010) The bundle identifier for this app is invalid.

AltStore.AppleDeveloperError

Updated information coming soon.

(3011) The bundle identifier for this app has already been registered.

AltStore.AppleDeveloperError

Updated information coming soon.

(3012) There is no App ID with the requested identifier on this team.

AltStore.AppleDeveloperError

Updated information coming soon.

(3013) You may only register 10 App IDs every 7 days.

AltStore.AppleDeveloperError

Updated information coming soon.

(3014) The provided app group is invalid.

AltStore.AppleDeveloperError

Updated information coming soon.

(3015) App group does not exist.

AltStore.AppleDeveloperError

Updated information coming soon.

(3016) The identifier for the requested provisioning profile is invalid.

AltStore.AppleDeveloperError

Updated information coming soon.

(3017) There is no provisioning profile with the requested identifier on this team.

AltStore.AppleDeveloperError

If you are seeing this error, it's likely due to a recent server-side change made by Apple. Please see the following announcement with more info: https://twitter.com/altstoreio/status/1638599316762664974?s=20

(3018) This account requires signing in with two-factor authentication.

AltStore.AppleDeveloperError

Updated information coming soon.

(3019) Incorrect verification code.

AltStore.AppleDeveloperError

Updated information coming soon.

(3020) Failed to perform authentication handshake with server.

AltStore.AppleDeveloperError

Updated information coming soon.

(3021) The provided anisette data is invalid.

AltStore.AppleDeveloperError

This error means that the information used to authenticate your AppleID information either expired or invalid. Make sure your computer date and time are accurate and that you’ve installed iTunes and iCloud from Apple.

Apple API Error

(1100) Your session has expired.

Apple.APIError

This error means that the information used to authenticate your Apple ID is either expired or invalid. Make sure your computer's date and time are accurate and try again.

(1102) Apple ID cannot be used for development.

Apple.APIError

You may need to agree to Apple’s Terms of Service on developer.apple.com. If that doesn’t work, you can create a new “throwaway” Apple ID dedicated to sideloading.

(-20101) Your account information was entered incorrectly.

Apple.APIError

This error means that the username or password used to authenticate your Apple ID is either expired or invalid. Make sure you've entered them both in correctly and that your computer's date and time are accurate.

Connection Errors

(0) Error Unknown.

AltServer.ConnectionError

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

(1) Device Locked.

AltServer.ConnectionError

This means that you will need to unlock your device before AltServer can connect.

(2) Invalid Request.

AltServer.ConnectionError

Updated information coming soon

(3) Invalid Response.

AltServer.ConnectionError

Updated information coming soon

(4) Usbmuxd.

AltServer.ConnectionError

Updated information coming soon

(5) SSL Error.

AltServer.ConnectionError

Updated information coming soon

(6) Timed Out.

AltServer.ConnectionError

Updated information coming soon

Windows Errors

(1100) Your session has expired. Please log in.

NSURLErrorDomain

  1. Make sure iTunes is closed.
  2. Go to Program Data -> Apple Computer -> iTunes -> ADI -> delete the files
  3. Start iTunes
  4. Retry installing SideStore

Other Errors

(512) Failed to write to disk

NSCocoaErrorDomain

This means that an error occurred while writing files to disk. Make sure your phone and PC both have plenty of available disk space and try again.

(1) AltJIT failed with error code 1 (iOS 17)

AltServer.ProcessError

If you are trying to enable JIT on an iOS 17 device, you may see this error. Make sure to install all dependencies and keep your device connected with the app open until JIT has successfully been enabled.