Skip to main content

Nvidia Jetson FAQ

  • The initialization on the Jetson devices will take a couple of minutes.
  • Your Jetpack version should match the version used by our software.


Docker is an open source platform for creating, deploying, and running containers. Docker is included in JetPack, so running containers on Jetson is easy and does not require any installation.

What are the dependencies? How do I fix "Unknown runtime specified nvidia"?#

  • Add Nvidia to the APT sources. On some distributions, Nvidia packages are not available by default. Edit /etc/apt/sources.list.d/nvidia-l4t-apt-source.list and uncomment the lines if necessary.

  • You can now install Jetpack libraries.

    • If you are on a storage constrained device, do the following and then restart.
sudo apt install nvidia-docker2 cuda-libraries-10-2sudo apt install cuda-compiler-10-2 graphsurgeon-tf nvidia-container-csv-cudasudo apt-get install nvidia-tensorrt nvidia-container-csv-tensorrt nvidia-container-csv-cudnn
  • Another option is to install the Jetpack meta-package (this will use more storage) and then restart.
sudo apt updatesudo apt install nvidia-jetpack

How do I run Docker as a non-root user?#

See those post installation steps.

How do I fix "OSError: cannot open shared object file: No such file or directory" ?#

If you are getting the error OSError: cannot open shared object file: No such file or directory it means the docker run command is missing the parameter --runtime nvidia.


NVIDIA JetPack SDK is the most comprehensive solution for building AI applications. It includes the latest OS images for Jetson products, along with libraries and APIs, samples, developer tools, and documentation.

I see error at the model optimization step. What do I do?#

If you see errors such as createInferBuilder_INTERNAL symbol not found., it means your JetPack version does not match the one used by the Docker image. Your options are:

  • Upgrade JetPack (see below).
  • Use a version of the software that matches your JetPack version (see below).

Which Jetpack version am I using?#

Install and run jetson-stats.

sudo apt install python3-pippip3 install -U jetson-statsjetson_release -v

How can I optimize RAM and storage usage?#

To free up RAM:

  • Boot in text mode sudo systemctl set-default In text mode, just after logging in, the device will use around 300MB of RAM.

To free up around 1.5G of storage, use

sudo apt purge thunderbird libreoffice* imagemagick chromium-* python3-pandas python3-numpy gnome-*sudo apt autoremove -y
# If you do not need a desktop environment, do the following:sudo apt remove ubuntu-desktop gdm3 unity gnome-icon-theme nvidia-l4t-graphics-demossudo apt autoremove -ysudo apt clean

How do I upgrade JetPack?#

Can I use a different JetPack version?#

If you use an older JetPack version, you can install an image that matches your version. See all the Stream tags available. And pick the one that matches your Jetpack. For example, if you use Jetpack r32.5.0, use the image platerecognizer/alpr-stream:jetson-1.25.1-r32.5.0.


Why does Stream/Snapshot stops working or the performance degrades after some time?#

Jetson devices can get hot under heavy use. If they are not properly cooled, the OS will automatically throttle the CPU/GPU. Make sure to use a fan.

Onboard Cameras#

How can I use an onboard camera?#

To use onboard cameras a few additional configurations are necessary.

First get your available camera resolutions

gst-launch-1.0 nvarguscamerasrc sensor-id=0

Set the camera url in config.ini to:

url = "nvarguscamerasrc ! video/x-raw(memory:NVMM),width=XXXXX, height=YYYYY, framerate=ZZZZZ/1, format=NV12 ! nvvidconv flip-method=0 ! video/x-raw,width=960, height=616 ! nvvidconv ! video/x-raw ! videoconvert ! video/x-raw,format=(string)BGR ! videoconvert ! appsink max-buffers=5"
For the commands above, make sure to:

Change XXXXX, YYYYY, and ZZZZZ to your values available to your camera. The framerate (FPS) of the camera could be any value below the available for the specified resolution.

Then you need to see where your onboard cameras are located:

ls -ltrh /dev/video*

If you only have one camera connected the output should be /dev/video0.

Now you can run the application. Notice the new environment variable -e OPENCV_API_PREFERENCE=1800, volume and device:

docker run \    -t \    --runtime nvidia \    --restart="unless-stopped" \    --privileged \    --group-add video \    --device ZZZZZ \    --name stream \    --user `id -u`:`id -g` \    -v /path/to/stream_dir:/user-data \    -v /tmp/argus_socket:/tmp/argus_socket \    -e OPENCV_API_PREFERENCE=1800 \    -e LICENSE_KEY=XXXXX \    -e TOKEN=YYYYY \    platerecognizer/alpr-stream:jetson

For the commands above, make sure to:

  1. Change XXXXX to the License Key that we gave you.
  2. Change YYYYY to your Plate Recognizer Token.
  3. Change ZZZZZ to your device from the previous output

How do I connect to an USB camera?#

  1. Find the id of the camera. For example, /dev/video0.
ls -ltrh /dev/video*
  1. Update the url parameter in your config.ini. Use the id of the camera from the previous command. For example, /dev/video0.
url = '/dev/video0'
  1. Start Stream with the docker run. Use the camera id from the previous commad. For example, /dev/video0. And set your own LICENSE_KEY, TOKEN and volume for /path/to/stream_dir.
docker run \    -t \    --runtime nvidia \    --privileged \    --name stream \    --user `id -u`:`id -g` \    -v /dev/video0:/dev/video0 \    -v /tmp/argus_socket:/tmp/argus_socket \    -v /path/to/stream_dir:/user-data \    -e OPENCV_API_PREFERENCE=200 \    -e LICENSE_KEY=XXXXX \    -e TOKEN=YYYYY \    platerecognizer/alpr-stream:jetson