Container CLI

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, --verbosestringfalseShows more logs, for issues we recommend turning it on before running nestri-server and sending the logs for debugging (i.e. nestri-server --verbose=true > logs.txt)
-d, --debug-feedstringfalseAdds a timer overlay at bottom-right in the video stream, along with spawning an X11 window on host for doing comparisons against
-u, --relay-urlstringhttps://relay.fst.soMoQ relay endpoint URL (must begin with https:// as MoQ can't work with unsafe connections)
-p, --relay-pathstringdefault generated on start if not setnamespace/path for the stream, identifies the stream (basically stream name), must be unique
Video
-r, --resolution string1280x720Sets nestri virtual display + stream resolution using WIDTHxHEIGHT format
-f, --framerateinteger60Framerate for nestri virtual display + stream
-g, --gpu-vendorstringallows selecting specific GPU by vendor name (nvidia, amd or intel)
-i, --gpu-indexstringallows selecting a GPU by it's general name, doesn't have to be full name as it's matched partially (i.e. 3060 would get you RTX 3060 GPU, but it would also let RTX 3060 Ti pass)
-a, --gpu-card-pathstringallows specifying GPU by /dev/dri/cardX or /dev/dri/renderX path, this won't work with the other 3 gpu parameters as it's explicitly setting the GPU
Encoder
-c, --encoder-vcodecstringh264Sets the stream video codec (h264 or av1)
-t, --encoder-typestringhardwareSets whether to use GPU encoder (hardware), or CPU encoder (software, only should be used with debugging or if GPU has no encoding capabilities)
-e, --encoder-namestringforces a specific encoder by GStreamer element name (i.e. vah264enc)
-q, --encoder-cqpstring25sets the stream quality level, lower means higher quality and much more bitrate used