LinuxCommandLibrary

ideviceimagemounter

Mount developer disk images on iOS devices

TLDR

Mount a disk image on the connected device

$ ideviceimagemounter [path/to/image_file] [path/to/signature_file]
copy

List currently mounted disk images
$ ideviceimagemounter --list
copy

SYNOPSIS

ideviceimagemounter [-d] [-u UDID] [-v] <IMAGE> <SIGNATURE>

PARAMETERS

-d, --debug
    Enable debug output for communication

-h, --help
    Display usage information

-u, --udid UDID
    Target specific device by UDID

-v, --version
    Print version information

DESCRIPTION

ideviceimagemounter is a command-line utility from the libimobiledevice project, designed to mount developer disk images (.dmg files) on connected iOS devices over USB. Primarily used by developers for debugging iOS apps on physical hardware, it simulates a ramdisk environment matching the device's iOS version.

The tool requires two files: a DeveloperDiskImage.dmg extracted from Xcode and its corresponding signature.plist. On Linux, it depends on libraries like libimobiledevice, libplist, and usbmuxd for device communication. Connect your iOS device, ensure it's trusted, and execute the command to mount the image, enabling advanced debugging features like LLDB symbolication.

Common in iOS reverse engineering and jailbreaking workflows, it supports multiple devices via UDID selection. Debug mode aids troubleshooting connection issues. Always match the image version to the target's iOS to avoid failures.

CAVEATS

Device must trust host; image must match iOS version exactly; requires usbmuxd running and libimobiledevice installed; fails on locked or unpaired devices.

EXAMPLE USAGE

ideviceimagemounter DeveloperDiskImage.dmg signature.plist
ideviceimagemounter -d -u 00008030-000000000000000 path/to/image.dmg path/to/sig.plist

REQUIREMENTS

libimobiledevice-utils package on Debian/Ubuntu; Xcode for disk images; USB connection with libusb.

HISTORY

Part of libimobiledevice since ~2010; supports iOS 3+; actively maintained for latest iOS versions via community contributions.

SEE ALSO

Copied to clipboard