# USB Guardian

USB Guardian is a self-hosted plugins app. Conservative safe-eject protection for supported USB mass-storage devices managed by Unassigned Devices. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4258/usb-guardian

## Description

Conservative safe-eject protection for supported USB mass-storage devices managed by Unassigned Devices. USB Guardian grants permission to unplug only after strict identity, usage, unmount, cache-flush, logical-removal, and shfs health checks pass.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Unraid: https://ca.unraid.net/apps/usb-guardian-0no0gjb0inpvvv?q=USB%20Guardian

## Common questions

### What checks does USB Guardian run before showing “Safe to unplug”?

It shows safe removal only after normal unmounting, a second usage scan, cache flushing, logical USB removal, and shfs stability checks all pass.

### Which USB storage devices are eligible for safe ejection?

Only fully verifiable USB mass-storage devices with a single disk are supported, and only one target mount may be active at a time. LUKS, ZFS, RAID/LVM members, multi-LUN enclosures, composite USB devices with non-storage interfaces, and devices with unproven identity are blocked with a reason.

### What Unassigned Devices settings can prevent USB Guardian from ejecting a drive?

UD Share must be disabled for the target partition, UD Destructive Mode must be off, and no disk, partition, User Script, or Common Script configuration may be present.

### Does the plugin force unmount or kill processes when a USB drive is in use?

No. It never uses lazy or forced unmounting and never kills processes automatically. If usage cannot be released safely, it stops and leaves the device connected.

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