SMART Sniffer works out of the box on most Linux, macOS, and Windows machines. But NAS devices, hypervisors, and containerized environments often need extra steps -- different device paths, protocol quirks, network bridge configs, or virtual disk limitations.
These guides walk through each platform step by step.
| Platform | What's covered |
|---|---|
| Proxmox + HA OS | Agent on the Proxmox host, integration in the HA VM. mDNS discovery, firewall rules, manual fallback. |
| Synology DSM | SynoCli for smartmontools 7.x, /dev/sataX device paths, --discover setup. |
| QNAP QTS | SAT protocol fallback, mDNS interface selection, LXC bridge exclusion. |
| TrueNAS SCALE | ZFS context, btrfs-progs for filesystem monitoring, immutable rootfs notes. |
| Unraid | Community guide -- br0 bridge, Docker-based deployment. (In progress) |
| Docker | Containerized agent deployment, device passthrough, known limitations. (In progress) |
| Virtual Machines | Generic VM guide -- ESXi, Hyper-V, VirtualBox. Why SMART data needs the host. |
| Hardware RAID Controllers | MegaRAID, HP SmartArray, 3ware, Areca. Manual device_overrides for RAID passthrough. |
The one rule for VMs and hypervisors: SMART data lives in the physical drive's firmware. Virtual disk controllers don't pass SMART commands through. Install the agent on the host (where the drives are), not in the VM. The HA integration in the VM discovers the agent over the network.
The one rule for NAS devices: Run smartha-agent --discover after install. It probes every drive, detects protocol mismatches, and offers to write the config for you.
Found a platform we haven't covered? Fix something that's wrong? Platform guides live in docs/guides/ and follow the same PR workflow as the rest of the repo. We especially welcome first-hand experience from users running SMART Sniffer on platforms marked (In progress).