idevicerestore - Restore IPSW firmware at PATH to an iOS device
Contents
Advanced/Experimental Options
-c,--custom
Restore with a custom firmware (requires bootrom exploit)
-s,--serverURL
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,--ticketPATH
Use file at PATH to send as AP ticket
--variantVARIANT
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. Usewithcaution.
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.
Name
idevicerestore - Restore IPSW firmware at PATH to an iOS device
On The Web
https://libimobiledevice.org
https://github.com/libimobiledevice/idevicerestore
idevicerestore(1)
Options
-i,--ecidECID
Target specific device by its ECID, e.g. 0xaabb123456 (hex) or 1234567890 (decimal).
-u,--udidUDID
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.
DONOTUSE if you need to preserve the baseband/unlock!
USEWITHCARE if you want to keep a jailbreakable firmware!
-e,--erase
Perform full restore instead of update, erasing all data
DONOTUSE 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. Usewithcaution.
-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-pathDIR
Use specified directory for caching extracted or other reused files.
-d,--debug
Enable communication debugging.
-v,--version
Prints version information.
Synopsis
idevicerestore [OPTIONS] PATH
