Installation
- You will need Docker and Docker-Compose installed.
- If you want to run OpenDataCam on a NVIDIA GPU you will additonally need
- Nvidia CUDA 11 and cuDNN 8
- Nvidia Container toolkit installed
- You also need to install
nvidia-container-runtime
- To run OpenDataCam on a NVIDIA Jetson device you will need Jetpack 5.x.
As Docker Container (Recommended)
This is the recommended way to install OpenDataCam. Follow the Quickstart Guide
Kubernetes
If you prefer to deploy OpenDataCam on Kubernetes rather than with Docker Compose, use the --orchestrator flag for changing the engine.
Apart from that, a Kubernetes distribution custom made for the embedded world would be K3s, which can be installed in 30 seconds by running:
curl -sfL https://get.k3s.io | sh -
Then, to automatically download and deploy the services:
# Download install script
wget -N https://raw.githubusercontent.com/opendatacam/opendatacam/master/docker/install-opendatacam.sh
# Give exec permission
chmod 777 install-opendatacam.sh
# Install command for Jetson Nano
./install-opendatacam.sh --platform nano --orchestrator k8s
# Install command for Jetson Xavier / Xavier NX
./install-opendatacam.sh --platform xavier --orchestrator k8s
# Install command for a Desktop machine
./install-opendatacam.sh --platform desktop --orchestrator k8s
NVIDIA offers a Kubernetes device plugin for detecting GPUs on nodes in case you are managing a heterogeneous cluster. Support for Jetson boards is being worked here
Balena
If you have a fleet of one or more devices, you can use balena to streamline deployment and management of OpenDataCam. You can sign up for a free account here and add up to ten devices at no charge. Use the button below to build OpenDataCam for a Jetson Nano, TX2, or Xavier. You can then download an image containing the OS, burn it to an SD card, and use balenaCloud to push OpenDataCam to your devices.
You can learn more about this deployment option along with a step-by-step guide in this recent blog post, or view a screencast of the deployment in action.