2025-06-03 21:13:25 +02:00

38 lines
1.1 KiB
Markdown

# 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:
```bash
docker exec <container-name> <app>
```