# USB Map

USB Map is a self-hosted infrastructure app. USB Map provides a map of your USB hardware for passthrough planning: each USB controller with its IOMMU group and whether it is safe to pass through to a VM (and which one holds the Unraid boot device), the USB 2 /... It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7679/usb-map

## Description

USB Map provides a map of your USB hardware for passthrough planning: each USB controller with its IOMMU group and whether it is safe to pass through to a VM (and which one holds the Unraid boot device), the USB 2 / USB 3 port pairs behind each physical connector, hubs, and devices with their link speed against the port maximum. Name your ports with Identify mode (plug something in, the port lights up). Thunderbolt / USB4 controllers are linked to their USB side. Read-only. Tools → USB Map.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 21 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/app_ca620cf82d7df86d
- GitHub: https://github.com/ibigsnet/UsbMap

## Common questions

### Where in Unraid do I find USB Map?

Open it from the Unraid interface under Tools, then USB Map.

### Does USB Map modify any system settings while it runs?

No, it is read-only and changes nothing on the system.

### Can USB Map help me choose a USB controller for VM passthrough?

Yes, it identifies xHCI controllers, IOMMU groups, and maps the PCI BDF to the USB bus and tree to help plan VFIO passthrough.

### Does USB Map show what USB speed a port is expected to support?

Yes, it identifies the expected USB standard and maximum speeds for the mapped hardware.

---
Source: Our Local Host (https://ourlocalhost.com/app/7679/usb-map), the self-hosted and open-source app directory.
