From 0fdc2c34b00300392e60fa1e590f3f3238848cf5 Mon Sep 17 00:00:00 2001 From: besendorf Date: Mon, 17 Aug 2026 13:42:22 +0200 Subject: [PATCH] Document iOS device access from Docker (#875) * Document iOS device access from Docker * Simplify docker.md instructions Removed unnecessary note about mounting the entire '/var/run' directory. --- docs/docker.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/docker.md b/docs/docker.md index d8f4ff8..453c245 100644 --- a/docs/docker.md +++ b/docs/docker.md @@ -31,4 +31,18 @@ Test if the image was created successfully: docker run -it mvt ``` -If a prompt is spawned successfully, you can close it with `exit`. \ No newline at end of file +If a prompt is spawned successfully, you can close it with `exit`. + +## Access an iOS device from Docker + +On the Linux host, install and start [usbmuxd](https://github.com/libimobiledevice/usbmuxd), then connect and unlock the iOS device. The daemon exposes the device through the `/var/run/usbmuxd` socket. + +Bind that socket into the container to let MVT communicate with the device: + +```bash +docker run -it \ + --mount type=bind,source=/var/run/usbmuxd,target=/var/run/usbmuxd \ + ghcr.io/mvt-project/mvt +``` + +If you built the image from source, replace `ghcr.io/mvt-project/mvt` with `mvt`.