XWAYLAND(1) General Commands Manual XWAYLAND(1)
NAME
Xwayland - an X server for running X clients under Wayland.
SYNOPSIS
Xwayland [option ...]
DESCRIPTION
Xwayland is an X server and a Wayland client. It plays the role of a
proxy between legacy X clients which do not support the Wayland proto-
cols and the Wayland server.
Usually, Xwayland is spawned automatically by the Wayland server and
runs rootless so that X clients integrate seamlessly with the rest of
the Wayland desktop. It is however possible for a user to launch Xway-
land non-rootless, mainly for testing purposes.
Like all of the X servers, Xwayland accepts the command line options de-
scribed in the Xserver(7) manual page. The following additional argu-
ments are supported as well.
-decorate
Add decorations to the Xwayland root window when running root-
ful.
This option has no effect when Xwayland is built without lib-
decor support (optional).
This option is not compatible with rootless mode (-rootless).
-enable-ei-portal
Enable support for the XDG portal for input emulation.
A Wayland compositor running nested should not use that command
line option with Xwayland.
This option has no effect if the compositor doesn't support the
relevant XDG portal or if Xwayland was not compiled with EI and
OEFFIS support.
-fullscreen
Set the Xwayland window fullscreen when running rootful.
This option is not compatible with rootless mode (-rootless).
-geometry WxH
Sets the geometry of the Xwayland window to WxH when running
rootful.
This option is not compatible with rootless mode (-rootless).
-glamor [gl|es|off]
Use given rendering API for Glamor acceleration. Possible op-
tions are gl and es. If Xwayland was compiled with Glamor sup-
port, this option will instruct Xwayland to use only requested
API for Glamor. If this set to off, effect is equal to -shm op-
tion. Without this option and without -shm option, Xwayland
tries the OpenGL rendering API first, and fallback to GL ES if
GL version is less than 2.1.
This option is not compatible with -shm option.
-hidpi Adjust to the scale of the outputs when running rootful in win-
dowing mode.
This option is not compatible with rootless mode (-rootless).
-host-grab
Disable host keyboard shorcuts and confine the pointer when run-
ning rootful.
This feature relies on the protocol for inhibiting the composi-
tor keyboard shortcuts and on the protocol for pointer locking
and confinement and may have no effect if the Wayland compositor
in use does not support these protocols.
Use the keys [CTRL]+[SHIFT] simultaneously to release the key-
board and pointer devices.
This option is not compatible with rootless mode (-rootless).
-initfd fd
Add the given fd as a listen socket for initialization of X
clients. This options is aimed at Wayland servers which run
Xwayland on-demand, to be able to spawn specific X clients which
need to complete before other regular X clients can connect to
Xwayland, like xrdb.
-listen fd
deprecated, use -listenfd instead.
-listenfd fd
Add given fd as a listen socket. This option is used by the Way-
land server to pass Xwayland the socket where X clients connect.
-noTouchPointerEmulation
Disable touch pointer emulation. This allows the Wayland compos-
itor to implement its own pointer emulation mechanism for X11
clients that don't support touch input.
-force-xrandr-emulation
Force additional non-native modes to be exposed when viewporter
is not supported by the Wayland compositor.
-nokeymap
Instructs Xwayland to ignore the keymap set by the Wayland com-
positor.
By default, Xwayland (as any Wayland client) uses the keymap set
by the Wayland compositor using the standard Wayland protocol.
This option is meant for some specific use cases where it may be
desirable to let the X11 clients control the keymap used in
Xwayland, ignoring the keymap specified by the Wayland composi-
tor. -output name Specifies on which output Xwayland fullscreen
rootful should be placed. The name must match the name of an
existing Wayland output (output names can be found using way-
land-info).
If no matching output can be found, the Wayland compositor will
decide on which output the fullscreen rootful Xwayland window
will be placed.
This option has no effect if Xwayland is not running fullscreen
rootful.
-rootless
Run Xwayland rootless, so that X clients integrate seamlessly
with Wayland clients in a Wayland desktop. That requires the
Wayland server to be an X window manager as well.
-shm Force the shared memory backend instead of glamor (if available)
for passing buffers to the Wayland server.
This option is not compatible with -glamor option.
-verbose [n]
Sets the verbosity level for information printed on stderr. If
the n value isn't supplied, each occurrence of this option in-
crements the verbosity level. When the n value is supplied, the
verbosity level is set to that value. The default verbosity
level is 0.
-version
Show the server version and exit.
-wm fd This option is used by the Wayland server to pass Xwayland the
socket where the X window manager client connects, when Xwayland
is running with -rootless.
ENVIRONMENT
WAYLAND_DISPLAY
the name of the display of the Wayland server.
XWAYLAND_NO_GLAMOR
disable glamor and DRI3 support in Xwayland, for testing pur-
poses.
SEE ALSO
General information: X(7), wayland-info(7)
X Version 11 xorg-server 24.1.6 XWAYLAND(1)
Generated by dwww version 1.16 on Sat Oct 3 07:20:13 CEST 2026.