Container CLI

Configure and manage your Nestri container environment using CLI parameters for relay settings, video resolution, GPU selection, and encoding options.

The Container CLI for Nestri provides parameters to configure and manage your container environment. Use these options to set values like relay-url, video resolution, and frame rate. Additionally, activate verbose mode and logging to assist in debugging and error tracking. This documentation details each parameter to help you optimize your container setup effectively

ParameterTypeDefaultDescription
-v, --verbosestringfalseEnable verbose output. Set to true for detailed logs.
-d, --debugstringfalseEnable additional debugging features. Set to true for extra debug information.
-u, --relay-urlstringNestri relay URL. Specify the URL for the Nestri relay server.
-r, --resolutionstring1280x720Display/stream resolution in 'WxH' format. Default is 1280x720.
-f, --frameratestring60Display/stream framerate. Default is 60 FPS.
--roomstringNestri room name/identifier. Specify the room for your Nestri session.
-g, --gpu-vendorstringGPU vendor to use (e.g., NVIDIA, AMD, Intel).
-n, --gpu-namestringGPU name to use. Specify the exact GPU model.
-i, --gpu-indexstring-1GPU index to use. Default is -1 (auto-select).
--gpu-card-pathstringForce a specific GPU by /dev/dri/ card or render path.
-c, --video-codecstringh264Preferred video codec. Options: h264, h265, av1. Default is h264.
--video-encoderstringOverride video encoder (e.g., nvenc, libx264).
--video-rate-controlstringcbrRate control method. Options: cqp, vbr, cbr. Default is cbr.
--video-cqpstring26Constant Quantization Parameter (CQP) quality. Default is 26.
--video-bitratestring6000Target bitrate in kbps. Default is 6000 kbps.
--video-bitrate-maxstring8000Maximum bitrate in kbps. Default is 8000 kbps.
--video-encoder-typestringhardwareEncoder type. Options: software, hardware. Default is hardware.
--audio-capture-methodstringpulseaudioAudio capture method. Options: pulseaudio, pipewire, alsa. Default is pulseaudio.
--audio-codecstringopusPreferred audio codec. Default is opus.
--audio-encoderstringOverride audio encoder (e.g., opusenc).
--audio-rate-controlstringcbrAudio rate control method. Options: cqp, vbr, cbr. Default is cbr.
--audio-bitratestring128Target audio bitrate in kbps. Default is 128 kbps.
--audio-bitrate-maxstring192Maximum audio bitrate in kbps. Default is 192 kbps.
--dma-bufstringfalseUse DMA-BUF for pipeline. Set to true to enable DMA-BUF support.
-h, --helpPrint help information for the CLI parameters.