docker-wayland-x-gui

This repository provides a reference setup to enable graphical applications (Wayland, X11, or XWayland) to be displayed on the host's compositor/display server. It also includes PipeWire and ALSA connections/pass-through for audio support.

Features

• Wayland, X11, and XWayland app support
• PipeWire and ALSA integration for sound
• Launch GUI apps from a Docker container directly on your host display
• Configurable UID/GID and mount paths to match your host environment

Prerequisites

• Docker installed and configured
• A Wayland-compatible host compositor (e.g., Sway, GNOME Shell, KDE, etc.)
• PipeWire and/or ALSA installed and running on the host

Configuration Notes

Depending on your system setup, you may need to adjust:

• Mount paths for Wayland/X11 sockets, sound devices, and config directories
• UID/GID inside the container to match your host user

By default:

• UID: 1000
• GID: 100

These can be overridden using environment variables.

Usage

You can launch apps from the host system into the running container using:

docker exec <container-name> <app>