Mesh Storage

Docker sample

Try the sample Alloy Edge Docker stack

This optional sample includes a ROS 2 recorder. If you already have a recorder, set up the Alloy Edge binary to upload its recordings.

Open the Docker setup in Mesh Storage → Devices → Add device → If you open Add device yourself, it shows the binary setup first. Select View Docker setup to switch. The setup flow provides the image commands and a Compose file with your provisioning key.

Docker setup showing image selection, registry access, and Compose download

Step 1: Pull the image

Choose the image version, the ROS 2 distribution (Jazzy or Humble), the architecture, and, if a Variant list is shown, the image variant. Then select Generate Access Command. Run the registry login and image pull commands shown there. The registry token expires after one hour.

Step 2: Configure and download the compose file

Choose a Middleware:

  • FastDDS is the default and works with Isaac Sim. If Alloy Edge shares topics with other ROS 2 containers, set Run as UID to match their UID; otherwise, topics may appear without data flowing.
  • CycloneDDS sets the container to use the CycloneDDS middleware. Choose it when your other ROS 2 nodes use CycloneDDS.
  • Zenoh is an option for communication across networks. The Compose file adds a Zenoh router container.

For every middleware, the generated Compose file uses host networking and ipc: host.

Select Download docker-compose.yml. The file includes your provisioning key.

Step 3: Run and approve

From the directory containing the downloaded Compose file, run:

docker compose up -d

In Mesh Storage → Devices, approve the pending device. Alloy then issues it a device API key automatically. Check Last seen and Files / Size on that page to confirm it is working.

The client needs outbound HTTPS access on port 443; it needs no inbound port.

On this page