Made for netPI, the Open Edge Connectivity Ecosystem
Debian with X.org display server, desktop Xfce and ALSA audio
The image provided hereunder deploys a container with installed Debian, display server, desktop environment and ssh server.
Base of this image builds a tagged version of debian:stretch with installed display server X.org enabling the device's HDMI port plus the desktop environment Xfce turning the device in a desktop computer with mouse and keyboard support. Additonally it embeds the ALSA Audio Sound package for sending the sound across HDMI.
The following host devices need to be exposed to the container
- for HDMI support the devices
- for mouse and keyboard support the device
- for sound over HDMI support the device
Only the privileged mode option lifts the enforced container limitations to allow usage of X.org display server in a container.
The container needs the "Host" network stack to be shared with the container.
STEP 1. Open netPI's landing page under
https://<netpi's ip address>.
STEP 2. Click the Docker tile to open the Portainer.io Docker management user interface.
STEP 3. Enter the following parameters under Containers > Add Container
Network > Network:
Restart policy" :
Runtime > Privileged mode :
Runtime > Devices > add device:
Host "/dev/tty0" -> Container "/dev/tty0"and
Host "/dev/tty2" -> Container "/dev/tty2"and
Host "/dev/fb0" -> Container "/dev/fb0"and
Host "/dev/input" -> Container "/dev/input"and
Host "/dev/snd" -> Container "/dev/snd"
STEP 4. Press the button Actions > Start container
Pulling the image from Docker Hub may take up to 5 minutes.
On Pi 3 for test
STEP 1. Establish a console connection to Pi 3.
STEP 2. Install Docker if not already done, else skip.
STEP 3. Run a container instance of the image using the following command line
Make sure you have a mouse and keyboard connected before you start the container, else they will not be recognized. A HDMI monitor will only be recognized if it was already connected during netPI'S boot sequence, else its screen remains black. For simple tests use Chromium to do some web page visits.
- hilscher/netPI-desktop-hdmi:latest - non-versioned latest development output of the master branch. Shouldn't be used since under development all the time.
GitHub sources and licenses
View the license information for the software in the Github project. As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
Hilscher Gesellschaft fuer Systemautomation mbH www.hilscher.com