Skip to main content
The ROS 2 packages live in the peaq-robotics-ros2 repository. Clone the workspace and choose either a Docker-based workflow or a native ROS 2 Humble setup. 
git clone https://github.com/peaqnetwork/peaq-robotics-ros2.git
cd peaq-robotics-ros2

# Build the development image
docker build -t peaq-ros2:latest .

# Start a container with workspace mounted
docker run -it --rm \
  --name peaq-ros2-dev \
  -v "$(pwd)":/work \
  -w /work \
  -p 5001:5001 -p 8080:8080 \
  peaq-ros2:latest

# Inside the container
source /opt/ros/humble/setup.bash
colcon build
source install/setup.bash
The Docker image installs ROS 2 Humble, Python dependencies, and build tooling. Exposed ports (5001, 8080) let IPFS nodes or optional managed gateways run locally when using the storage bridge.

​
Native Humble Setup

git clone https://github.com/peaqnetwork/peaq-robotics-ros2.git
cd peaq-robotics-ros2

# Install Python requirements
pip install -r requirements.txt

# Ensure ROS 2 Humble is installed and sourced
source /opt/ros/humble/setup.bash

# (Optional) install additional system dependencies
sudo rosdep init 2>/dev/null || true
rosdep update
rosdep install --from-paths . --ignore-src -r -y || true

# Build the workspace
colcon build
source install/setup.bash

​
IPFS (with Optional Managed Pinning)

The storage bridge relies on an IPFS node. Follow the repository guide to install Kubo, run ipfs daemon, and optionally supply managed gateway credentials (e.g., Pinata, web3.storage) in the configuration file when required. Continue with configuration once the workspace builds successfully.