Skip to content

Instantly share code, notes, and snippets.

@hhhaiai
Forked from stonehippo/docker_usb_guest_osx.md
Created January 31, 2023 08:33
Show Gist options
  • Save hhhaiai/f57f1637edb5ca7bcfe90a4c7a45b873 to your computer and use it in GitHub Desktop.
Save hhhaiai/f57f1637edb5ca7bcfe90a4c7a45b873 to your computer and use it in GitHub Desktop.
Getting a USB device to show up in a Docker container on OS X

Getting a USB device to show up in a Docker container on OS X

Some background

I was trying to get the Arduino IDE to work inside a Docker container on OS X. I was able to get the IDE working (see Getting X11 GUI applications to work on OS X with Docker), but I could not figure out how to make the USB port for the Arduino visible.

The solution

I first tried to directly map hardware serial port into the Docker container, doing something like this:

$ docker run -it --rm --device=/dev/tty.usbserial ubuntu bash

This failed. After thinking about it, I realized that of course it would. Docker on OS X runs inside of Virtualbox VM. And it's that VM that a Docker container would need to see. Duh.

With this realization, I was able to make this work pretty easily. First, make sure the Docker VM that you want to use has USB enabled. You can see this in the summary info for the VM. If it's not enabled, make sure the VM is stopped, with

$ docker-machine stop [vm name]

Then go into Virtualbox, locate the VM and enter its Settings. From there, go to Ports -> USB and enable the USB controller (I choose USB 2.0). Save the settings, and fire up the VM again with

$ docker-machine start [vm name]

Once the VM is started, open it in Virtualbox by clicking Show or double-clicking it. Once you're in the VM, select Devices -> USB from the menu and enable what devices you want to use from the HOST in the guest (and, by extension, in the Docker container).

Once that's all set, your device should be available in the VM. For example, after following these steps, I could now see the Arduino as /dev/ttyUSB0 in the guest. And now I can map the USB device into the container like this:

$ docker run -it --rm --device=/dev/ttyUSB0 ubuntu bash

A quick test with the screen command showed that the Arduino was now available. Yay!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment