Configure the Linux Agent

[encode]
codec = "h264"
default_bitrate_kbps = 5000
default_fps = 30

These are starting settings, not performance or colour guarantees. Leave the optional backend override unset for automatic selection unless the exact path is being tested. Session controls can request supported encoding changes.

Normal Linux capture is eight-bit. Experimental X11 SDR ten-bit is opt-in with a 30 fps cap. The Wayland ten-bit prototype is not a production configuration option.

Diagnostic gates

VDO_AUDIO_MODE supports native, pw-record and parec. VDO_NVENC_MODE supports auto, dmabuf/zerocopy and copy. Use a gate only for a reviewed issue on that host, not as a fleet-wide default.

The session launcher reads the root-owned worker environment on startup. Preserve known-good configuration and apply changes during idle maintenance. Do not edit an old per-user unit or restart an occupied broker to try an override.

See Manage the Linux Agent and GPU encoding.