1idevicerestore(1) General Commands Manual idevicerestore(1)
2
6 idevicerestore - Restore IPSW firmware at PATH to an iOS device
7
9 idevicerestore [OPTIONS] PATH
10
13 Restore firmware files to iOS devices while either erasing the device
14 or updating to preserve content and settings.
15 PATH can be a compressed .ipsw file or a directory containing all files
17 extracted from an IPSW.
18
21 -i, --ecid ECID
22 Target specific device by its ECID, e.g. 0xaabb123456 (hex) or
23 1234567890 (decimal).
24 -u, --udid UDID
26 Target specific device by its device UDID.
27 NOTE: only works with devices in normal mode.
29 -l, --latest
31 Use latest available firmware (with download on demand). Before
32 performing any action it will interactively ask to select one of
33 the currently signed firmware versions, unless -y has been given
34 too.
35 The PATH argument is ignored when using this option.
37 DO NOT USE if you need to preserve the baseband/unlock!
39 USE WITH CARE if you want to keep a jailbreakable firmware!
41 -e, --erase
43 Perform full restore instead of update, erasing all data
44 DO NOT USE if you want to preserve user data on the device!
46 -y, --no-input
48 Non-interactive mode, do not ask for any input.
49 WARNING: This will disable certain checks/prompts that are sup‐
51 posed to prevent DATA LOSS. Use with caution.
52 -n, --no-action
54 Do not perform any restore action. If combined with -l option
55 the on-demand ipsw download is performed before exiting.
56 --ipsw-info
58 Print information about the IPSW at PATH and exit.
59 -h, --help
61 Prints usage information.
62 -C, --cache-path DIR
64 Use specified directory for caching extracted or other reused
65 files.
66 -d, --debug
68 Enable communication debugging.
69 -v, --version
71 Prints version information.
72
75 -c, --custom
76 Restore with a custom firmware (requires bootrom exploit)
77 -s, --server URL
79 Override the default signing server request URL. If the URL
80 doesn't contain a path component, the default path /TSS/con‐
81 troller?action=2 will be added.
82 -x, --exclude
84 Exclude nor/baseband upgrade.
85 NOTE: This option only works with legacy devices and/or custom
87 firmware.
88 -t, --shsh
90 Fetch TSS record and save to .shsh file, then exit.
91 -z, --no-restore
93 Do not restore and end after booting to the ramdisk.
94 -k, --keep-pers
96 Write personalized components to files for debugging.
97 -p, --pwn
99 Put device in pwned DFU mode and exit (limera1n devices only).
100 -P, --plain-progress
102 Print progress as plain step and progress
103 -R, --restore-mode
105 Allow restoring from Restore mode
106 -T, --ticket PATH
108 Use file at PATH to send as AP ticket
109 --variant VARIANT
111 Use given VARIANT to match the build identity to use, e.g. 'Cus‐
112 tomer Erase Install (IPSW)'
113 --ignore-errors
115 Try to continue the restore process after certain errors (like a
116 failed baseband update).
117 WARNING: This might render the device unable to boot or only
119 partially functioning. Use with caution.
120
123 Martin Szulecki
124 Nikias Bassen
126 Joshua Hill
128
131 https://libimobiledevice.org
132 https://github.com/libimobiledevice/idevicerestore
134 idevicerestore(1)