NAME
idevicerestore - Restore IPSW firmware at PATH to an iOS device
SYNOPSIS
idevicerestore [OPTIONS] PATH
DESCRIPTION
Restore firmware files to iOS devices while either erasing the device or updating to preserve content and settings.
PATH can be a compressed .ipsw file or a directory containing all files extracted from an IPSW.
OPTIONS
- -i, --ecid ECID
-
Target specific device by its ECID, e.g. 0xaabb123456 (hex) or 1234567890 (decimal).
- -u, --udid UDID
-
Target specific device by its device UDID.
NOTE: only works with devices in normal mode.
- -l, --latest
-
Use latest available firmware (with download on demand). Before performing any action it will interactively ask to select one of the currently signed firmware versions, unless -y has been given too.
The PATH argument is ignored when using this option.
DO NOT USE if you need to preserve the baseband/unlock!
USE WITH CARE if you want to keep a jailbreakable firmware!
- -e, --erase
-
Perform full restore instead of update, erasing all data
DO NOT USE if you want to preserve user data on the device!
- -y, --no-input
-
Non-interactive mode, do not ask for any input.
WARNING: This will disable certain checks/prompts that are supposed to prevent DATA LOSS. Use with caution.
- -n, --no-action
-
Do not perform any restore action. If combined with -l option the on-demand ipsw download is performed before exiting.
- --ipsw-info
-
Print information about the IPSW at PATH and exit.
- -h, --help
-
Prints usage information.
- -C, --cache-path DIR
-
Use specified directory for caching extracted or other reused files.
- -d, --debug
-
Enable communication debugging.
- -v, --version
-
Prints version information.
ADVANCED/EXPERIMENTAL OPTIONS
- -c, --custom
-
Restore with a custom firmware (requires bootrom exploit)
- -s, --server URL
-
Override the default signing server request URL. If the URL doesn't contain a path component, the default path /TSS/controller?action=2 will be added.
- -x, --exclude
-
Exclude nor/baseband upgrade.
NOTE: This option only works with legacy devices and/or custom firmware.
- -t, --shsh
-
Fetch TSS record and save to .shsh file, then exit.
- -z, --no-restore
-
Do not restore and end after booting to the ramdisk.
- -k, --keep-pers
-
Write personalized components to files for debugging.
- -p, --pwn
-
Put device in pwned DFU mode and exit (limera1n devices only).
- -P, --plain-progress
-
Print progress as plain step and progress
- -R, --restore-mode
-
Allow restoring from Restore mode
- -T, --ticket PATH
-
Use file at PATH to send as AP ticket
- --variant VARIANT
-
Use given VARIANT to match the build identity to use, e.g. 'Customer Erase Install (IPSW)'
- --ignore-errors
-
Try to continue the restore process after certain errors (like a failed baseband update).
WARNING: This might render the device unable to boot or only partially functioning. Use with caution.
AUTHORS
Martin Szulecki
Nikias Bassen
Joshua Hill
ON THE WEB
https://libimobiledevice.org
https://github.com/libimobiledevice/idevicerestore