Overview
All-in-one Docker for Orbbec depth cameras: includes drivers, ROS 2 samples, RViz2 setup—ideal for fast testing and development on any Linux host.
Orbbec Gemini 3D Camera ROS2 Demo
About Advantech Container Catalog
Advantech Container Catalog is a comprehensive collection of ready-to-use, containerized software packages designed to accelerate the development and deployment of Edge AI applications. By offering pre-integrated solutions optimized for embedded hardware, it simplifies the challenges often faced with software and hardware compatibility, especially in GPU/NPU-accelerated environments.
Key benefits of the Container Catalog include:
Feature / Benefit | Description |
---|---|
Accelerated Edge AI Development | Ready-to-use containerized solutions for fast prototyping and deployment |
Hardware Compatibility Solved | Eliminates embedded hardware and AI software package incompatibility |
GPU/NPU Access Ready | Supports passthrough for efficient hardware acceleration |
Model Conversion & Optimization | Built-in AI model quantization and format conversion support |
Optimized for CV & LLM Applications | Pre-optimized containers for computer vision and large language models |
Open Ecosystem | 3rd-party partners can integrate new apps to expand the platform |
Container Overview
This container, Orbbec Gemini 3D Camera ROS2 Demo, provides a complete demonstration environment for Orbbec depth cameras using ROS 2. It includes:
-
Orbbec camera drivers
-
Functional sample packages
-
Pre-configured RViz2 visualization
-
Udev rules and system setup scripts for camera detection
Designed for quick testing, development, and evaluation of Orbbec cameras on any Linux host with Docker installed.
Container Demo
Point Cloud Voxelization
Voxel filtering reduces point cloud density, improving processing speed and system performance.
DepthPointCloud
Converts depth information into 3D point cloud data.
Colored Point Cloud
Generates colored point clouds by aligning RGB images with depth maps.
Local Costmap
The local costmap reflects real-time perception of the robot's immediate surroundings.

Key Features
-
Pre-installed ROS 2 (Humble)
-
Built-in OrbbecSDK ROS 2 wrapper
-
Supports RViz2 visualization
-
Includes RGB/Depth/IR/D2C/PointCloud demos
-
Launch-ready functional AMR-style example
-
Works out of the box with supported USB-connected Orbbec devices
Host Device Prerequisites
Platform | Compatibility |
---|---|
x86_64 | Tested |
Prerequisite Software on the Host OS
Before running the container, ensure that your host system has the following software installed:
-
Docker Engine
Version 20.10 or newer is recommended for best compatibility.
Installation guide: https://docs.docker.com/engine/install/ -
Docker Compose
Required for managing multi-container setups.
Installation guide: https://docs.docker.com/compose/install/ -
NVIDIA Container Toolkit
Required to enable GPU access inside containers. This toolkit provides the necessary runtime for Docker to interface with the NVIDIA driver and GPU resources.
Installation guide (official): https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.htmlNote for users in mainland China:
If you experience slow or blocked access tonvidia.github.io
, consider using a domestic mirror (e.g., USTC) to install the toolkit.
Container Environment Overview
Software Components Inside the Container Image
-
Base Image:
ubuntu:22.04
-
ROS 2: Humble Hawksbill (also supports Foxy/Jazzy if rebuilt)
-
OrbbecSDK_ROS2: ROS 2 wrapper for Orbbec camera SDK
-
amr_multi_cam: Sample functional package for multi-camera use case
-
RViz2: Pre-installed for visualization
-
colcon, argcomplete, image_transport_plugins, and others
Container Quick Start Guide
For container quick start, including docker-compose file, and more, please refer to Advantech EdgeSync Container Repository - Orbbec ROS 2 Demonstration Container
About Orbbec
Dedicated to All things for 3D Vision since 2013. From sensors to silicon, algorithms to AI, design to production, supply-chain to manufacturing.
More info regarding Orbbec, visit Orbbec Official Website.