Skip to content

Instantly share code, notes, and snippets.

@stonehippo
Last active June 12, 2024 10:36
Show Gist options
  • Save stonehippo/e33750f185806924f1254349ea1a4e68 to your computer and use it in GitHub Desktop.
Save stonehippo/e33750f185806924f1254349ea1a4e68 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!

@rubberduck203
Copy link

In particular, the official Arduino Unos, but I would expect difficulty on any model using the ATMEGA16U2 chip for USB communications.

Clones that use an FTDI, like the Sparkfun Redboard work fine.

@lmapii
Copy link

lmapii commented Oct 22, 2019

Oh my, down memory lane ... @pklapperich as @rubberduck203 mentioned it's not really working for all devices. I'm now still sticking to a very specific setup as mentioned here, these were the only versions that would support all devices I'm using within docker in the project.

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