Docker Access to Raspberry Pi GPIO Pins

Nyxynyx picture Nyxynyx · May 5, 2015 · Viewed 20.1k times · Source

When running Docker on the Raspberry Pi 2, how can we expose the GPIO pins to the Docker container?

Answer

Tobias picture Tobias · Jan 12, 2018

On a Linux host, there are three possible ways to get access to the GPIO pins from within a Docker container.

1. Running Docker with the "--privileged" option

Starting a container like this will give the container full access to the host's devices, including GPIO:

$ docker run --privileged -d whatever

Check the Docker documentation on this option. It might not be the best choice depending on how tight your security requirements are.

2. Adding the /dev/gpiomem device

Rather than exposing all of the host's devices to the container, you can be specific and only expose the /dev/gpiomem device to the container at runtime. Be aware that this device needs kernel driver support within the host's Linux distribution. Recent releases of Raspbian should have this. Your mileage with other distributions may vary.

$ docker run --device /dev/gpiomem -d whatever

3. Using the sysfs filesystem on the host

The Pi's GPIO is represented within the host's file system underneath /sys/class/gpio. This can be accessed with user privileges via the virtual files in that file system. Use Docker volumes to expose this to your container:

$ docker run -v /sys:/sys -d whatever

Mind that using sysfs for GPIO is probably going to be slower than the device approach.

GPIO libraries

Which of these three approaches fits your needs will also depend on the libraries you are using when accessing GPIO. Not all libraries support all three of these options.