Troubleshooting

My application fails to stream during local validation

Below are a few potential reasons why you may encounter this, including troubleshooting steps.

Host desktop is being streamed to the browser

If you are seeing your own desktop window streamed in the browser, it is likely due to an overlapping nvstreamer-server running. Execute the following command to display all instances of nvstreamer:

ps aux | grep nvstreamer

Look for a duplicate nvstreamer process as shown below. In this example, the top one is the conflicting process:

nvidia    2772  0.0  0.0   7372  2920 ?           Ss   May13   0:00 /bin/bash /opt/nvidia/nvstreamer/bin/startnvst.sh
nvidia    2780  0.3  5.4 10220164 1779680 ?       Sl   May13  11:56 /opt/nvidia/nvstreamer/bin/../server/nvstreamer

You may kill this process or disable the nvstreamer server by invoking the following command:

systemctl --user stop nvstreamer-server

To fully disable the server, run this command:

sudo systemctl disable nvstreamer-server

You may need to stop and re-launch the Docker container using this command:

docker container stop CONTAINER_ID

docker run --runtime=nvidia --gpus all --net=host usd-viewer

Black viewport screen: Application not yet ready

This can occur if the shaders are still being compiled when the Web Client connects to the streaming Kit application. Depending on the number of unique shaders, compiling may take several minutes.

Once all shaders are compiled and the application is ready, you should see the message RTX ready in your container’s terminal.