cage(1) General Commands Manual cage(1)

# [NAME](#NAME)

cage - a Wayland kiosk compositor

# [SYNOPSIS](#SYNOPSIS)

**cage** \[options...] \[--] \[*application*...]

# [DESCRIPTION](#DESCRIPTION)

Cage runs a single, maximized application. Cage can run multiple applications, but only a single one is visible at any point in time. User interaction and activities outside the scope of the running application are prevented.

# [OPTIONS](#OPTIONS)

**-d**

Don't draw client side decorations when possible.

**-D**

Enable debug logging.

**-h**

Show the help message.

**-m** <mode>

Set the multi-monitor behavior. Supported modes are: **last** Cage uses only the last connected monitor. **extend** Cage extends the display across all connected monitors.

**-s**

Allow VT switching

**-v**

Show the version number and exit.

# [ENVIRONMENT](#ENVIRONMENT)

*DISPLAY*

If compiled with Xwayland support, this will be set to the name of the X display used for Xwayland. Otherwise, probe the X11 backend.

*WAYLAND\_DISPLAY*

Specifies the name of the Wayland display that Cage is running on.

*XCURSOR\_PATH*

Directory where cursors are located.

*XCURSOR\_SIZE*

Specifies the configured cursor size.

*XCURSOR\_THEME*

Specifies the configured cursor theme.

*XKB\_DEFAULT\_RULES*, *XKB\_DEFAULT\_MODEL*, *XKB\_DEFAULT\_LAYOUT*, *XKB\_DEFAULT\_VARIANT*, *XKB\_DEFAULT\_OPTIONS*

Configures the xkb keyboard settings. See [**xkeyboard-config**(7)](/man/enterprise-packages/cage/xkeyboard-config.7).

# [SEE ALSO](#SEE_ALSO)

[**xkeyboard-config(7)**](/man/enterprise-packages/cage/xkeyboard-config.7)

# [BUGS](#BUGS)

Report bugs at https://github.com/cage-kiosk/cage

# [AUTHORS](#AUTHORS)

Jente Hidskes <dev@hjdskes.nl>

2026-10-30

---

Document: cage(1) from cage 0.3.1-r3 (Chainguard OS)
Source: https://github.com/cage-kiosk/cage