Cydia · Troubleshooting

• Yellow text: a warning. Usually harmless and can be ignored.
• Red text: an error. It can stop the refresh or block installation, so it needs handling.

Most errors come from the network; the rest are usually cache or repo problems. When you hit one, work through these in order:

1. Switch to a stable Wi‑Fi network (or turn off your VPN) and refresh sources again.
2. Swipe Cydia away from the app switcher to quit it completely, reopen it, and wait for the refresh at the top to finish before doing anything.
3. If it still fails, match your message against the cases below.

"Failed to fetch" / "Operation timed out"

Typical output:

Failed to fetch http://xxx/Release.gpg ...POSIX: Socket is not connectedPOSIX: Operation timed out

Cause: Cydia cannot reach that repo's server. Either your network is the problem, or the server is temporarily down.

What to do:

• Refresh again on a more reliable network. Some carriers block overseas repos, so try switching between Wi‑Fi and cellular.
• If only one repo fails, it is most likely under maintenance. Refresh again later — the other repos are unaffected.

"Some index files failed to download"

Cause: one or more repo lists did not download during the refresh, so Cydia is still using the previous lists.

What to do: refresh sources once more and let the progress bar at the top finish. Do not cancel halfway.

"HTTP/1.1 500" or "HTTP/1.0 403"

• 500 Internal Server Error: the repo server is failing or overloaded. Wait a while and refresh again.
• 403: you are not allowed to download this package. It usually means the product needs a paid license. Make sure it is purchased and activated, or contact that product's support.

"Size mismatch"

Cause: the downloaded file size does not match what the repo reports. Usually the refresh did not finish, the network was unstable, or the repo itself is faulty (mirrors and cracked repos are the common offenders).

What to do:

1. Go to Sources → Edit and delete the repo that is failing.
2. Return to the home screen and wait for Cydia to finish refreshing.
3. Add the repo again, wait for the refresh to complete, then install.

"Hash Sum mismatch"

Cause: the checksum of the downloaded package does not match the repo. Most often an incomplete download left a corrupted cache entry.

What to do:

1. Quit Cydia completely, reopen it, refresh sources and try installing again.
2. If it still fails, use a file manager such as Filza to empty /var/cache/apt/archives, then retry.
3. If the error persists, the package in that repo is broken. Use the official repo, or try again later.

"I wasn't able to locate file for the app"

Cause: the package did not download completely (occasionally the package itself is broken).

What to do: swipe Cydia away from the app switcher to quit it, reopen it, refresh sources, then install again.

"trying to overwrite …, which is also in package …"

Cause: the package you are installing shares files with something already on the device. This typically happens when upgrading, or when the same product is installed from two different repos.

What to do: uninstall the old version first, restart SpringBoard, then install the new one. Install from the official repo where possible, and do not mix in mirrors or cracked repos.

"Root directory's space is not enough"

The device is out of storage. Free up some space under Settings → General → iPhone Storage by removing photos, videos or apps, then install again.

Adding a repo fails, or spins forever

• Check the address for typos — copy it from the Overview page
• Switch Wi‑Fi networks or turn off your VPN, then try again
• Make sure Cydia can already load its default repos before adding a third-party one

The repo is added but searching finds nothing

1. Go back to Sources and pull down to refresh, or wait for the refresh to finish
2. Search by English name or product name, such as CTW, AMG or VBox
3. Try the AZ repo https://apt.azcydia.com and search there as well

Install fails after tapping Install, or reports a dependency error

• Let Cydia install the missing dependencies, then try again
• Free up storage if space is low
• Restart Cydia or reboot the device, then install again

Installed, but there is no icon on the home screen

• Did you restart SpringBoard?
• Open Installed and confirm the package status is Installed rather than an error

Still listed after uninstalling, or it will not uninstall

• Follow Uninstall a package and use Modify → Remove
• If it reports that other packages depend on it, remove those dependants first

Refreshing is very slow

• Too many repos slows the refresh down. Delete the ones you rarely use and keep only the AZ repo or the official repo you actually need.
• Let the progress bar at the top finish. Do not tap cancel — a lot of strange errors are caused by an interrupted refresh.