besendorf
0fdc2c34b0
* Document iOS device access from Docker * Simplify docker.md instructions Removed unnecessary note about mounting the entire '/var/run' directory.
1.6 KiB
Using Docker simplifies having all the required dependencies and tools (including most recent versions of libimobiledevice) readily installed. Note that this requires a Linux host, as Docker for Windows and Mac doesn't support passing through USB devices.
Install Docker following the official documentation.
Once Docker is installed, you can run MVT by downloading a prebuilt MVT Docker image, or by building a Docker image yourself from the MVT source repo.
Using the prebuilt Docker image
docker pull ghcr.io/mvt-project/mvt
You can then run the Docker container with:
docker run -it ghcr.io/mvt-project/mvt
Build and run Docker image from source
git clone https://github.com/mvt-project/mvt.git
cd mvt
docker build -t mvt .
Test if the image was created successfully:
docker run -it mvt
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, 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:
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.