System Requirements

Operating System

OS	Version	Status
Ubuntu	24.04 LTS (Noble Numbat)	✅ Supported
Other Ubuntu	22.04 Jammy, 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
Humble Hawksbill	🔜 Planned (ROB-10)
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 Robot Agent: Features)
• TF storage savings: ~99% reduction in transform tree storage for stationary robots via snapshot deduplication
• CPU overhead: Benchmark targets: < 5% additional CPU vs. unmonitored ROS2 (results coming soon — see rmw_robotops #41)
• Latency overhead: Target: < 1µs per message for tracing (results coming soon)

Network

• The agent communicates with api.robotops.com over gRPC (HTTPS/443)
• 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 api.robotops.com

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}
      - RMW_IMPLEMENTATION=rmw_robotops
      - ROBOTOPS_UNDERLYING_RMW=rmw_fastrtps_cpp
    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.