[Help] TOS 7 - USB passthrough support

Install virtual machines on your TNAS;
User avatar
polen
Posts: 16
Joined: 01 May 2026, 07:50
United States of America

Re: [Help] TOS 7 - USB passthrough support

Post by polen »

@Gremlin
Your explanation to @TM was a great way to highlight the gap.

I’d like to add some clarification based on my own testing. USB passthrough does technically work in TOS 7, and @TM even states this in their documentation. However, from what I’m seeing, the current implementation appears to only support USB storage devices, not non‑storage USB hardware such as the HubZ Smart Home Controller (VID:PID 10c4:8a2a) .

I’ve tested multiple USB storage devices, and every one of them is detected and can be passed through without issue .
But non‑storage devices never appear as selectable options in the VM interface, even though they show up correctly in lsusb.

What’s confusing is that TOS 7’s VM system already runs on top of a storage subsystem, so limiting passthrough to storage‑only devices feels counterintuitive. If anything, the devices users most need to pass through — Zigbee/Z‑Wave radios, UPS interfaces, smart‑home controllers, etc. — are non‑storage peripherals.

Hopefully this helps @TM understand the practical gap between “USB passthrough exists” and “USB passthrough is actually usable for real‑world VM workloads.”
Hardware: F6-424 Max, 24GB RAM, 3 x 12TB WD Red Plus TRAID, 2 x NVMe 2TB TRAID, 2 x 500GB SD Ultra 3D RAID1 Quick Cache, 1 x 18TB WD USB3 Backup
Operating System: TOS 7.0.0791
Applications: Plex, VMs, Docker, USB Copy
User avatar
polen
Posts: 16
Joined: 01 May 2026, 07:50
United States of America

Re: [Help] TOS 7 - USB passthrough support

Post by polen »

When I pass a USB drive through to a VM, the VM boots normally, but the TNAS console logs a warning saying the USB device was “abnormally ejected.” This only happens when USB passthrough is enabled.


Image
Hardware: F6-424 Max, 24GB RAM, 3 x 12TB WD Red Plus TRAID, 2 x NVMe 2TB TRAID, 2 x 500GB SD Ultra 3D RAID1 Quick Cache, 1 x 18TB WD USB3 Backup
Operating System: TOS 7.0.0791
Applications: Plex, VMs, Docker, USB Copy
User avatar
polen
Posts: 16
Joined: 01 May 2026, 07:50
United States of America

Re: [Help] TOS 7 - USB passthrough support

Post by polen »

Whoop! New version of VMs (1.0.055) fixes my issue with using USB passthrough. Home Assistant work perfectly on VMs with this new version. Thank you, Terra Master. You have been crushing it with your recent updates.


Image
Hardware: F6-424 Max, 24GB RAM, 3 x 12TB WD Red Plus TRAID, 2 x NVMe 2TB TRAID, 2 x 500GB SD Ultra 3D RAID1 Quick Cache, 1 x 18TB WD USB3 Backup
Operating System: TOS 7.0.0791
Applications: Plex, VMs, Docker, USB Copy
User avatar
polen
Posts: 16
Joined: 01 May 2026, 07:50
United States of America

Re: [Help] TOS 7 - USB passthrough support

Post by polen »

FYI: I have Uninstalled VirtualBox.
Hardware: F6-424 Max, 24GB RAM, 3 x 12TB WD Red Plus TRAID, 2 x NVMe 2TB TRAID, 2 x 500GB SD Ultra 3D RAID1 Quick Cache, 1 x 18TB WD USB3 Backup
Operating System: TOS 7.0.0791
Applications: Plex, VMs, Docker, USB Copy
User avatar
MikeZhang
TM Support
Posts: 416
Joined: 05 Sep 2023, 22:21

Re: [Help] TOS 7 - USB passthrough support

Post by MikeZhang »

polen wrote: 26 Jul 2026, 00:22
Thanks for the update and your feedback.
To contact our team, please send email to following addresses, remember to replace (at) with @

Technical team: support(at)terra-master.com(for technical support)
Service team: service(at)terra-master.com(for purchasing, return, replacement, RMA service)
User avatar
petrose
Posts: 24
Joined: 26 Dec 2025, 19:08
Denmark

Re: [Help] TOS 7 - USB passthrough support

Post by petrose »

Interesting, I cannot install VirtBox due to the dependency of PHP 7.4 which breaks during install :shock:
Following from the syslog when trying install:

Code: Select all

Jul 26 17:50:26 SonjaNAS application[15873]: DEBUG /usr/bin/systemctl disable PHP74
Jul 26 17:50:26 SonjaNAS application[15873]: Shell execute error. Error=Failed to disable unit: Unit file PHP74.service does not exist.#012: exit status 1
Jul 26 17:50:30 SonjaNAS application[50603]: E: dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem.
Jul 26 17:50:30 SonjaNAS application[15873]: Application install failed:install error
Jul 26 17:50:31 SonjaNAS application[15873]: App operation error. AppID=PHP74 Operate=install Error State=2
Jul 26 17:50:31 SonjaNAS application[15873]: App state will be deleted. AppID=PHP74Box since the required PHP7.4 won't install.
This is also reported in another thread: viewtopic.php?p=59044&sid=2090d124182d8 ... df2#p59044
a few days ago.
Did you at any point ran the command suggested 'dpkg --configure -a'
?
BR PetRose
My TNAS: F8 SSD Plus, now with TOS7 Final version along with 1+3x2 TB SSD sticks, formatted as BTRFS and using TRAID
User avatar
CursaYang
TM Support
Posts: 789
Joined: 06 Jan 2025, 16:34
China

Re: [Help] TOS 7 - USB passthrough support

Post by CursaYang »

petrose wrote: 30 Jul 2026, 18:45
If you previously installed PHP version 7.4.33.3, reinstalling or updating the software may leave residual files, which could prevent the current 7.4.33.12 version from being installed properly.
You can run this command to complete the installation process for software packages that have already been unpacked but are not yet fully configured.
To contact our team, please send email to following addresses, remember to replace (at) with @

Technical team: support(at)terra-master.com(for technical support)
Service team: service(at)terra-master.com(for purchasing, return, replacement, RMA service)
Post Reply

Return to “Virtual Machines”