idevicebackup2(1)

πŸ“¦
version 1.4.0 Β· 3 versions
, in alpine 3.24, arch rolling, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ idevicebackup2 β€” the backup bestie ✨

okay so real talk, <pink>idevicebackup2(1)</pink> is that girl from the <lavender>General Commands Manual</lavender> who handles creating and restoring backups for devices running iOS 4 or later. she's giving main character energy in the libimobiledevice friend group and honestly? we're obsessed πŸ’–


🌸 NAME 🌸

idevicebackup2 β€” Create or restore backups for devices running iOS 4 or later.


πŸŽ€ SYNOPSIS πŸŽ€

idevicebackup2 [OPTIONS] CMD [CMDOPTIONS] DIRECTORY

πŸ¦‹ DESCRIPTION πŸ¦‹

Create or restore backup in/from the specified directory. that's it, that's the whole vibe β€” you point her at a DIRECTORY and she either packs everything up or puts it all back, no cap ✨


πŸ’… OPTIONS πŸ’…

  • -u, --udid UDID β€” target specific device by UDID. like, pick your fave by name (well, by UDID, but you get it).
  • -s, --source UDID β€” use backup data from device specified by UDID. the backup source is a different device than the target, and that's valid πŸ’β€β™€οΈ
  • -i, --interactive β€” request passwords interactively on the command line. safest way to do passwords, fr fr πŸ‘‘
  • -n, --network β€” connect to network device.
  • -d, --debug β€” enable communication debugging. for when you need to see everything, absolutely everything 🫢
  • -h, --help β€” prints usage information.
  • -v, --version β€” prints version information.

🌈 COMMANDS 🌈

πŸ’œ backup

create backup for the device. she's collecting everything, periodt.

  • --full β€” force full backup from device.

πŸ’œ restore

restore last backup to the device.

  • --system β€” restore system files, too.
  • --no-reboot β€” do NO reboot the system when done. (yes, the manpage literally yells NO, we respect the drama.)
  • --copy β€” create a copy of backup folder before restoring. safety first bestie πŸ’–
  • --settings β€” restore device settings from the backup.
  • --remove β€” remove items which are not being restored.
  • --skip-apps β€” do not trigger re-installation of apps after restore.
  • --password PWD β€” supply the password for the encrypted source backup. If omitted, the password will be requested in interactive mode (-i), or it can be passed using the environment variable BACKUP_PASSWORD.

πŸ’œ info

show details about last completed backup of device.

πŸ’œ list

list files of last completed backup in CSV format. spreadsheet girlies rise πŸ™ˆ

πŸ’œ unback

unpack a completed backup in DIRECTORY/_unback_/

πŸ’œ encryption on|off [PWD]

enable or disable backup encryption. The password will be requested in interactive mode (-i) if omitted, or it can be passed using the environment variable BACKUP_PASSWORD.

πŸ’œ changepw [OLD NEW]

change backup password on target device. The passwords will be requested in interactive mode (-i) if omitted, or they can be passed using the environment variables BACKUP_PASSWORD (old password) and BACKUP_PASSWORD_NEW (new password) respectively.

πŸ’œ cloud on|off

enable or disable cloud use (requires iCloud account).


πŸ”₯ SECURITY CONSIDERATIONS πŸ”₯

Passing passwords on the command line is not advised, since it might reveal the backup password to other users via process list or command line history. Use interactive mode (-i) or pass them via environment variable(s) as mentioned in the description of the respective commands above.

like, don't do it bestie, your password would be out there for the whole group chat to see 😭 use -i or the env vars, ok? 🫢


πŸ‘‘ AUTHORS πŸ‘‘

  • Martin Szulecki
  • Nikias Bassen

legends, genuinely. ate and left no crumbs πŸ’…


🌐 ON THE WEB 🌐


okay that's the whole page!! this was <rainbow>idevicebackup2(1)</rainbow> from the <lavender>General Commands Manual</lavender>, and if you ever forget her name just remember: idevicebackup2(1), always in the footer, always iconic β­πŸ§šβ€β™€οΈπŸ’–