mirror of
https://github.com/mvt-project/mvt.git
synced 2024-06-02 03:05:30 +00:00
1f049fc8ba
Had to run an additional Docker flag to get it building on the new M1 chip from Apple. Figured it would be helpful to point that out in the Docs for the less initiated users.
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
Using Docker simplifies having all the required dependencies and tools (including most recent versions of [libimobiledevice](https://libimobiledevice.org)) readily installed.
|
|
|
|
Install Docker following the [official documentation](https://docs.docker.com/get-docker/).
|
|
|
|
Once installed, you can clone MVT's repository and build its Docker image:
|
|
|
|
```bash
|
|
git clone https://github.com/mvt-project/mvt.git
|
|
cd mvt
|
|
docker build -t mvt .
|
|
```
|
|
|
|
Optionally, you may need to specify your platform to Docker in order to build successfully (Apple M1)
|
|
```bash
|
|
docker build --platform amd64 -t mvt .
|
|
```
|
|
|
|
Test if the image was created successfully:
|
|
|
|
```bash
|
|
docker run -it mvt
|
|
```
|
|
|
|
If a prompt is spawned successfully, you can close it with `exit`.
|
|
|
|
If you wish to use MVT to test an Android device you will need to enable the container's access to the host's USB devices. You can do so by enabling the `--privileged` flag and mounting the USB bus device as a volume:
|
|
|
|
```bash
|
|
docker run -it --privileged -v /dev/bus/usb:/dev/bus/usb mvt
|
|
```
|
|
|
|
**Please note:** the `--privileged` parameter is generally regarded as a security risk. If you want to learn more about this check out [this explainer on container escapes](https://blog.trailofbits.com/2019/07/19/understanding-docker-container-escapes/) as it gives access to the whole system.
|
|
|
|
Recent versions of Docker provide a `--device` parameter allowing to specify a precise USB device without enabling `--privileged`:
|
|
|
|
```bash
|
|
docker run -it --device=/dev/<your_usb_port> mvt
|
|
```
|