# Deadlock Guard

Deadlock Guard is a beta Unraid 7.3.x plugin that prevents virtual machine (VM) and Docker hardware-passthrough deadlocks by grouping workloads that share the same graphics processing unit (GPU) or peripheral component. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7648/deadlock-guard

## Description

Deadlock Guard is a beta Unraid 7.3.x plugin that prevents virtual machine (VM) and Docker hardware-passthrough deadlocks by grouping workloads that share the same graphics processing unit (GPU) or peripheral component interconnect (PCI) device. It enforces exclusive use through Unraid's native VMs, Docker, and Dashboard controls, stopping conflicting workloads before the requested workload starts. It is for Unraid administrators running passthrough hardware; direct Docker starts and automatic restart/update paths bypass enforcement.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Unraid: https://ca.unraid.net/apps/app_56b4ff8dd5914815
- GitHub: https://github.com/ghaschel/unraid-deadlock-guard

## Common questions

### Do I need to reboot after installing Deadlock Guard?

Yes, after the first installation, reboot Unraid when safe to activate VM protection. Then open Settings -> Deadlock Guard and check the integration status.

### How do I create a group for VMs and containers that share hardware?

Open Settings -> Deadlock Guard and add a group. Select the VMs and containers that use the same hardware. Choose whether the group applies to WebUI, API, or both, then save.

### Does stopping a VM or container in a group start another one automatically?

No, stopping a VM or container never starts another. Deadlock Guard handles the stop/start sequence when you use the normal Start control.

### Do direct Docker commands, direct VM starts, or automatic starts obey Deadlock Guard?

Direct Docker commands and automatic starts bypass handoffs. Direct starts of grouped VMs are blocked by the VM safety gate, but this is not system-wide exclusivity.

---
Source: Our Local Host (https://ourlocalhost.com/app/7648/deadlock-guard), the self-hosted and open-source app directory.
