Add a Matter device to a second fabric using chip-tool multi-admin (open commissioning window and re-pair)

domain: project-chip.github.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Commission the device onto the first fabric with chip-tool pairing ble-wifi or ble-thread, assigning a local node ID
  2. From the first fabric's administrator, open an Enhanced Commissioning Window on the device: chip-tool pairing open-commissioning-window <node_id> 1 <timeout_seconds> <iteration> <discriminator>; record the printed manual pairing code
  3. Switch chip-tool to the second fabric context using the --commissioner-name beta flag (or a separate storage path) so the second admin has its own fabric credentials
  4. Commission the device onto the second fabric using the pairing code obtained in step 2: chip-tool --commissioner-name beta pairing code <new_node_id> <pairing_code>
  5. Verify both fabrics are present on the device by reading the Operational Credentials cluster: chip-tool --commissioner-name alpha operationalcredentials nocs read 0 0
  6. Remove a fabric when no longer needed with chip-tool operationalcredentials remove-fabric <fabric_index> <node_id> <endpoint>

Known gotchas

Related routes

Use chip-tool interactive mode and the Matter fabric-admin example to synchronize devices across fabrics
project-chip.github.io · 6 steps · unrated
commission a matter device onto wi-fi using chip-tool's pairing ble-wifi command
project-chip.github.io · 5 steps · unrated
Commission a Matter device over Thread using chip-tool and a Border Router
matter-thread · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans