Host configuration
Configure beam-host via environment variables. Values in ~/.config/beam/host.env are loaded by the systemd user service after enrollment.
Core
| Variable | Default | Description |
|---|
BEAM_TOKEN | — | Host secret token (required) |
BEAM_SIGNAL_URL | ws://localhost:8080/signal | WebSocket signaling endpoint |
BEAM_BACKEND | auto | auto, nvidia, or vaapi |
Video
| Variable | Default | Description |
|---|
BEAM_FPS | 60 | Target frame rate |
BEAM_BITRATE_KBPS | 20000 | Maximum bitrate (adaptive AIMD caps here) |
BEAM_CODEC | auto | Codec negotiation override |
BEAM_OUTPUT | -1 | XRandR monitor index; -1 = primary |
Audio
| Variable | Default | Description |
|---|
BEAM_AUDIO | 1 | Set 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