Librealsense Docker

This tutorial aim is to provide instructions for installation and use of Librealsense Docker. Current version of the docker includes the following capabilities:

use of librealsense devices
use of librealsense API
installation of the basic examples for use of librealsense

It does not include (may be enabled later on):

graphic examples
use of IMU devices

Pre-Work: Docker Installation

Install docker in the environemnt using the following tutorial (adjust for the OS): https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04

Dockerfile description

Ubuntu base system (Ubuntu 20.04 by default)
librealsense-builder stage - builds the binaries and has all the build dependencies
librealsense stage - contains only the built binaries and the required runtime dependencies (~60MB)
Support for Python bindings (python not included) and networking
Binaries are stripped from debug symbols during build stage to minimize image size
Support scripts for building and running the image are also included
Next steps - TODO: python version, openGL, self info to be printed

Getting librealsense docker - pre-built

In order to use the built container by our latest Dockerfile, run the command:

docker pull librealsense/librealsense

This will pull librealsense docker saved in Docker Hub.

Please pay attention that librealsense Docker is available only for x86 at this stage.

Running the Container

Before running the container, make sure that when running the command: docker images, the docker librealsense/librealsense appears. Then, the container can be ran by one of the following ways:

Remark: In each of the alternative ways, the aim of the lines: --device-cgroup-rule "c 81:* rmw" \ --device-cgroup-rule "c 189:* rmw" \ is to grant access for the docker to the USB and UVC resources of the host PC (needed to use realsense devices).

Default Command

Running the container with default command:

docker run -it --rm \
    -v /dev:/dev \
    --device-cgroup-rule "c 81:* rmw" \
    --device-cgroup-rule "c 189:* rmw" \
    librealsense/librealsense

The default command that will run is: rs-enumerate-devices --compact

Custom Command

In order to run some arbitrary command (run of the rs-depth demo in the following example), one can run for example:
```
docker run -it --rm \
    -v /dev:/dev \
    --device-cgroup-rule "c 81:* rmw" \
    --device-cgroup-rule "c 189:* rmw" \
    librealsense/librealsense rs-depth
```
Then, the realsense depth will be displayed as in the following video:

Running shell

Use the following command in order to interact with the Docker via shell interface:

docker run -it --rm \
    -v /dev:/dev \
    --device-cgroup-rule "c 81:* rmw" \
    --device-cgroup-rule "c 189:* rmw" \
    librealsense/librealsense /bin/bash

Building librealsense docker image

The librealsense's docker image can be built locally using the Dockerfile. This is done by running the image building script - run it in the following way:

./build_image.sh

Then, running the container is done as described above .

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!