v7.8.0

7.8.0 - 2026-01-17

Fixed

• --hostdisplay --xauth: fix cookie if extension SECURITY is missing.
  (557)
• WSL2g: don't default to --runx if DISPLAY is set.
  (557)
• WSL2g: use socat to create a unix socket from virtual socket.
  (557)
• WSL2: Improved IP check.
  (557)
• --xc: fix command order for xtool() and nvidia driver installation.
• /etc/profile.d/10-x11docker-env.sh: Do not set DISPLAY,
  set XAUTHORITY=~/.Xauthority in ssh sessions.
  (554)
• fix ps calls for alpine/busybox. Use psproc on MSYS2 and Cygwin.
  (556)
  (558)
• --wm: minor fixes.
• --xc --backend=host: fix backend check rootfull or rootless.

Changed

• --weston-xwayland: Support rootless Xwayland.
• --weston-xwayland: Support option --wayland.
• --weston =[ARG]: New optional arguments,
  --weston=x: runs --weston-xwayland --wayland
--weston=X: runs --weston-xwayland --wayland --desktop
  (501)
• --hostwayland: Can be set additionally to X server options
  to run X and Wayland applications side by side.
• --hostdisplay: Use XlibNoSHM.so without --xc, too.
• --xc using a tty: Needs --xc=force with NVIDIA.
• --clipboard: Support Wayland. Drop primary support.
  Deprecate argument oneway: New arguments c2h, h2c.
  Deprecate arguments superv|altv: New argument cmv.
  Wayland keybinding with x11docker/xserver.

Added

• --xw: New option to run X and Wayland apps side by side.
• --pipewire: New option for PipeWire sound in container.
  (545)
  (527)
  (507)
  (418)
  (380)
• --xeyes: New option to run xeyes, can help with
  --clipboard=cmv in Wayland+X11 containers (option --xw).
• Partial support of Docker Desktop edition.

Deprecated

• --backend=nerdctl: Deprecated, likely rarely used.
• --runtime=kata-runtime: Deprecated, likely rarely used.
  (543)
• --build: Deprecated, would have needed ADD support.
• --gpu: Deprecated argument virgl.

v7.7.1

7.7.1 - 2025-011-23

Fixed

• --xc --xorg: Add /dev/tty0 /dev/fb0. Needed on Debian trixie
  to run from console.
• --xc --weston*: Use --ipc=host for X container. Needed for
  Debian trixie X container to run nested in X.
• --xc --gpu: fix nvidia driver installation in X container
• --xc=docker --backend=podman: Fix capabilities / DAC_OVERRIDE
• --xc --gpu: fix check for already installed NVIDIA driver.
• --password: Show host user name for container user password.
  (535)
  (537)

v7.7.0

7.7.0 - 2025-011-18

Fixed

• --password: fix mkdir issue if ~/.config/x11docker does not exist.
  (535)
  (537)
• --xwayland: use -decorate.
• --*xwayland': use -force-xrandr-emulation.
• --weston-xwayland: print -xoptpossibilities.
• --backend: Docker Desktop: Exit with error, not supported.
• ssh: add softlink to ~/.Xauthority and create /run/sshd.
  Create helper script /x11docker/sshenvfor environment setup.
  (554)
• jq and python parsing.
  (525)
  (485)
  (493)
  (504)
• --pulseaudio: share cookie file.
  (507)
• mygetent(): check for system getent.
  (496)
  (510)

Added

• --xopt=ARG: Add custom arguments to X server command.

Deprecated

• --kwin: Deprecated because of issues and likely rare use.
  Use --weston instead.

v7.6.0

7.6.0 - 2023-01-18

Changed

• --install|--update|--update-master: Up to version 7.5.0
  x11docker installed itself with prefix /usr,
  now it uses /usr/local. This serves to follow the
  Linux Foundation specifications of /usr/local.
  To help with the transition, a new option --remove-oldprefix
  was introduced.
  An update from previous versions must be done twice to take effect.
  Recommended procedure:
  • First run: x11docker --update
  • Again run: x11docker --update
  • Afterwards run: x11docker --remove-oldprefix

Added

• --remove-oldprefix: Remove installation in old prefix /usr.
  (479)

v7.5.0

7.5.0 - 2023-01-16

Added

• man page for x11docker. (Run update from 7.4.2 twice to install it.)
  (469)

Fixed

• --tty failed with --xc. Fix: disable --xc.
  (464)
• --xonly: run socat unprivileged to make the unix socket accessible.
  (466)
• --share: Softlink fix for folders in HOME.
  (475)
• jq support to lessen python dependency.
  (478)
• Replace getent with custom grep command.
  (477)
• --install|--update*: Do not depend on backend.
  (470)

Deprecated

• --backend=proot: Deprecated because likely no one uses it,
  but would need further checks and maintenance.

v7.4.2

7.4.2 - 2022-08-7

Fixed

• --xpra*: Fix for Wayland+X11 on host. Use Wayland for xpra client.
  Caused startup failure along with --xc.
  (462)
• --hostwayland: Do not use container of x11docker/xserver (option --xc).
• --fullscreen: Enable desktop mode.
• Do not set --hostname to avoid --network issues.
  (463)
• --runtime=sysbox: support --gpu=virgl again.

Deprecated

• --runtime=kata-runtime: recent kata v2.x does not provide kata-runtime.

v7.4.1

7.4.1 - 2022-08-03

Changed

• --update, --update-master: New optional argument diff to show
  the difference between installed and new version without installing it.
  (460)

Fixed

• --xpra*: Fix check for xinitrc is ready.
  (462)

v7.4.0

7.4.0 - 2022-07-28

Added

• --xauth [=yes|trusted|untrusted|no]: New option to configure X cookie.
• --printcheck: New option to show X server dependency check messages.

Changed

• --xoverip: New optional arguments yes|no|socat|listentcp.
  socat allows X over TCP with --hostdisplay and Xwayland related options.
• --gpu: changed X dependency checks.
• --hostdisplay --gpu --xc=no: Do not enable --ipc=host automatically.

Fixed

• --user: Fix in setup of /etc/gshadow.
• --xc: Provide X unix socket to host with socat instead of ln.
  GTK3 application failed to access X through a soft link.
• --shell --no-setup: Set environment variable SHELL.
  (457)
• --no-setup: Share init binary from host instead of using --init.
  (457)

Deprecated

• --no-auth: Use --xauth=no instead.
• --enforce-i: Create group weston-launch instead and add your user to it.

v7.3.2

7.3.2 - 2022-07-08

Added

• --clipboard=yes: Limited support for Wayland clients.
  (Host X to container Wayland only.)

Fixed

• --xc: Don't add groups video or render if they do not exist.
  (454)

v7.3.1

7.3.1 - 2022-07-01

Added

• --xc: Support --kwin, nested and on console.
• --xc: Support --xpra-xwayland.

Fixed

• --xc: Add missing code for --xvfb.
  (452)
• --xc: Provide --hostdisplay dependencies.