Attention

As of June 30, 2025, the Isaac ROS Buildfarm for Isaac ROS 2.1 on Ubuntu 20.04 Focal is no longer supported.

Due to an isolated infrastructure event, all ROS 2 Humble Debian packages that were previously built for Ubuntu 20.04 are no longer available in the Isaac Apt Repository. All artifacts for Isaac ROS 3.0 and later are built and maintained with a more robust pipeline.

Users are encouraged to migrate to the latest version of Isaac ROS. The source code for Isaac ROS 2.1 continues to be available on the release-2.1 branches of the Isaac ROS GitHub repositories.

The original documentation for Isaac ROS 2.1 is preserved below.

Troubleshooting

Troubleshooting techniques for different problems that you might run into while setting up Isaac ROS.

• Developer Environment
  • GXF Failure due to Tensor Stream Creation Failed
  • Docker buildx plugin not installed
  • Repository cloned without pulling git-lfs files
  • X11-forward issue
  • ROS 2 Domain ID Collision
  • No /opt/ros/humble/install directory in Docker container
• Hardware Setup
  • RealSense Driver Does Not Work with ROS 2 Humble
  • Input Images Must Have an Even Height and Width
  • RealSense ros2 launch realsense2_camera rs_launch.py Error
  • Failed to Get Valid Output from Isaac ROS Rectify or AprilTag Node
  • RealSense Does Not Stream IR Stereo Images
  • RealSense Error Failed to resolve the request
  • RealSense incompatible QoS Policy Error
  • Linker Error foo.so: file format not recognized; treating as linker script
  • Intel RealSense Camera Accidentally Enables Laser Emitter
  • Intel RealSense D455’s Infra Camera Capped at 15fps
• Deep Learning
  • Seeing operation failed followed by the process dying
  • Triton fails to create the TensorRT engine and load a model