# 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>
```