System Requirements

Operating System

OS	Version	Status
Ubuntu	24.04 LTS (Noble Numbat)	✅ Supported (amd64 + arm64)
Ubuntu	22.04 LTS (Jammy Jellyfish)	✅ Supported (arm64 / Jetson; amd64 in progress)
Other Ubuntu	20.04 Focal	🔜 Planned (ROB-10)
Other Linux	Debian, RHEL, Arch, etc.	⚠️ Unsupported (Docker only)
macOS	Any	⚠️ Unsupported (Docker only)
Windows	Any	⚠️ Unsupported (Docker only)

ROS2 Distribution

Distribution	Status
Jazzy Jalisco (Ubuntu 24.04)	✅ Supported (amd64 + arm64)
Humble Hawksbill (Ubuntu 22.04)	✅ Supported (arm64 / Jetson; amd64 in progress)
Rolling Ridley	🔜 Planned (ROB-10)

Architecture

Architecture	Status
amd64 (x86_64)	✅ Supported
arm64 (aarch64)	✅ Supported

Hardware

The TraceHouse™ agent is designed for a small footprint and low overhead:

• Local buffer: 500 MB FIFO buffer for offline operation (configurable — see TraceHouse Agent: Features)
• TF storage savings: ~99% reduction in transform tree storage for stationary robots via snapshot deduplication
• Tracing overhead: The SDK hot path is near-zero-cost — spans are batched and exported asynchronously off the critical path, over a local Unix socket; the ros2_control integration is RT-safe

Network

• The agent communicates with backend.robotops.com over gRPC (HTTPS/443) — configurable via ROBOT_OPS_AGENT_BACKEND_URL
• In offline mode (no network or no API key), all telemetry is buffered locally in MCAP files and uploaded when connectivity is restored — no data is lost
• Firewall requirements: outbound TCP 443 to backend.robotops.com (and apt.robotops.com for installation)

Running on macOS or Windows (Development Only)

ROS2 Jazzy does not have native macOS or Windows support. For local development and evaluation, use Docker:

# docker-compose.yml
services:
  robot-dev:
    image: ros:jazzy
    environment:
      - ROBOTOPS_API_KEY=${ROBOTOPS_API_KEY}
      # SDK env-default auto-init (see Instrumentation)
      - LD_PRELOAD=/opt/ros/jazzy/lib/librobotops_trace_autoinit.so
      - ROBOTOPS_TRACE_AUTOINIT=1
    volumes:
      - .:/workspace
    network_mode: host
    command: bash -c "source /opt/ros/jazzy/setup.bash && exec bash"

caution

This setup is intended for local development and evaluation on macOS or Windows. For production use, deploy on native Ubuntu 24.04.