---
name: "wlheadless-run"
section: "1"
platform: "linux"
package: "xwayland-run"
version: "0.0.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wlheadless-run"
---

# wlheadless-run(1)

Run a Wayland client on a dedicated headless Wayland compositor.

## NAME

wlheadless-run - Run a Wayland client on a dedicated headless Wayland compositor.

## SYNOPSIS

**wlheadless-run** \[-c compositor \] \[compositor option ...\] -- client \[client options ...\]

## DESCRIPTION

*wlheadless-run* is used to spawn a given Wayland client on a dedicated Wayland compositor running headless.

## OPTIONS

- **-c COMPOSITOR**

  Use the compositor class implementation. Currently supported compositor classes are *weston*, *kwin*, *mutter*, *gnome-kiosk*, *cage*.

## FILES

- *wlheadless.conf*

  Sets the default compositor to use.

The file is searched in **wlheadless** directory relative to the paths specified in the standard environment variables **XDG\_DATA\_HOME** and **XDG\_DATA\_DIRS**.

\[DEFAULT\]\
     Compositor = weston

## SEE ALSO

[*weston*(1)](/weston/1.md),  [*cage*(1)](/cage/1.md),  [*mutter*(1)](/mutter/1.md)