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

                                                                                idevicerestore(1)