USB Passthrough

USB passthrough gives a virtual machine direct access to a USB device connected to the server. The device is detached from the host and presented to the VM as if it were physically connected.

Enable a USB Device

Mark a USB device as available for passthrough. This is a hypervisor-level operation — no VM needs to be involved.

1. Navigate to the hypervisor's detail page in the Gallium Console.
2. Select the Passthrough tab.
3. Under USB Devices, find the device you want to enable.
4. Click Enable.

The device is detached from the host and becomes available to attach to a VM.

Add to a VM

Attach an enabled USB device to a virtual machine. The VM must be stopped.

1. Navigate to the VM's detail page.
2. Select the Hardware tab.
3. Under Passthrough Devices, click Add Device.
4. Select the USB device from the list of available devices.
5. Click Add.

The device will be available to the VM the next time it starts.

Remove from a VM

Detach a USB device from a virtual machine. The VM must be stopped.

1. Navigate to the VM's detail page.
2. Select the Hardware tab.
3. Under Passthrough Devices, find the device you want to remove.
4. Click Remove.
5. Confirm the removal.

The device returns to the list of available passthrough devices and can be assigned to another VM.

Disable a USB Device

Return a USB device to host use. The device must not be assigned to any VM.

1. Navigate to the hypervisor's detail page.
2. Select the Passthrough tab.
3. Under USB Devices, find the device you want to disable.
4. Click Disable.

The device is reattached to the host and is no longer available for passthrough.