Host configuration

Configure beam-host via environment variables. Values in ~/.config/beam/host.env are loaded by the systemd user service after enrollment.

Core

VariableDefaultDescription
BEAM_TOKENHost secret token (required)
BEAM_SIGNAL_URLws://localhost:8080/signalWebSocket signaling endpoint
BEAM_BACKENDautoauto, nvidia, or vaapi

Video

VariableDefaultDescription
BEAM_FPS60Target frame rate
BEAM_BITRATE_KBPS20000Maximum bitrate (adaptive AIMD caps here)
BEAM_CODECautoCodec negotiation override
BEAM_OUTPUT-1XRandR monitor index; -1 = primary

Audio

VariableDefaultDescription
BEAM_AUDIO1Set 0 to disable system audio
BEAM_AUDIO_DEVICE@DEFAULT_MONITOR@PulseAudio source (monitor of default sink)

Service management

systemctl --user status latenz-host
systemctl --user restart latenz-host
journalctl --user -u latenz-host -f