Skip to content

Add macOS UTM Docker installation guide#1682

Merged
microtechno9000 merged 4 commits intoautomatic-ripping-machine:mainfrom
RayHollister:main
Feb 17, 2026
Merged

Add macOS UTM Docker installation guide#1682
microtechno9000 merged 4 commits intoautomatic-ripping-machine:mainfrom
RayHollister:main

Conversation

@RayHollister
Copy link
Copy Markdown
Contributor

This PR adds a new wiki page documenting how to install ARM using Docker inside a UTM virtual machine on macOS.

Why this approach?

macOS cannot natively pass USB devices to Docker containers. This guide provides a workaround using UTM's QEMU backend to run Ubuntu Server in a VM, which then runs ARM in Docker with proper USB passthrough to optical drives.

Key points covered:

  • UTM installation and QEMU backend requirement (Apple Virtualization doesn't support USB passthrough)
  • Ubuntu Server VM setup for both Apple Silicon and Intel Macs
  • USB DVD drive passthrough configuration
  • Docker and ARM container setup
  • Optional VirtFS shared media library for direct output to macOS folders
  • Troubleshooting common issues

Testing

This guide has been tested and verified working on a Mac Mini M4 with an external USB DVD drive.

Copy link
Copy Markdown
Collaborator

@microtechno9000 microtechno9000 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please include an update to the side bar so users can find the page from the wiki

- **Alternate Installations**

@microtechno9000 microtechno9000 added the Awaiting feedback Waiting for user to test fixes label Feb 4, 2026
Added macOS with UTM (Docker) link at the end of the "Alternate Installations" section
Added the > [!CAUTION] block right after the title, matching the format from the Debian install page.
@sonarqubecloud
Copy link
Copy Markdown

Copy link
Copy Markdown
Collaborator

@microtechno9000 microtechno9000 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for adding a guide for mac :)

@microtechno9000 microtechno9000 merged commit 9cbf971 into automatic-ripping-machine:main Feb 17, 2026
11 of 13 checks passed
uprightbass360 pushed a commit to uprightbass360/automatic-ripping-machine-neu that referenced this pull request Feb 18, 2026
* Add macOS UTM Docker installation guide

* Update _Sidebar.md

Added macOS with UTM (Docker) link at the end of the "Alternate Installations" section

* Update Alternate-Install-macOS-UTM.md

Added the > [!CAUTION] block right after the title, matching the format from the Debian install page.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Awaiting feedback Waiting for user to test fixes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants