iOS setup for device tunneling

This guide provides step-by-step instructions to set up device tunneling for iOS devices, enabling seamless local testing and debugging.

Testing on iOS devices requires additional dependencies and permissions on your local machine.

Dependencies

You must have the required command-line tools installed to interact with iOS devices.

• macOS: libimobiledevice is required. You can install it using Homebrew:

• Linux: libimobiledevice, usbmuxd, and [socat](https://www.kali.org/tools/socat/) are required. You can install them using your system’s package manager.

Required permissions

The tunnel needs administrator privileges to manage the usbmuxd socket that communicates with iOS devices. You can grant these permissions automatically or manually.

Automatic setup (Recommended for CI/CD)

Provide your system password either in the advanced configuration file or using the --system-auth command-line flag. This allows the tool to run without manual intervention.

Manual setup

If you do not provide a password, you will see a standard GUI prompt asking for administrator credentials when you run the start command with the --enable-ios flag.

Related topics

• Getting started - Install the tool and run your first tunnel.
• Advanced configuration - Customize tunnel settings for performance and security.
• CLI reference & management - Explore command-line options for managing device tunnels.
• Troubleshooting guide - Find solutions to common issues with device tunneling.