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.

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 -dIn 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.