Skip to content

Docker Compose Requires /dev/accel Devices Even Though NPU Is Documented as Optional #1891

@arunimakanavu

Description

@arunimakanavu

Description

The system requirements documentation states that NPU hardware is optional for the Multi-Modal Patient Monitoring suite.

However, docker-compose.yaml unconditionally exposes accelerator devices:

devices:
  - /dev/dri
  - /dev/accel
  - /dev/accel/accel0

If /dev/accel/accel0 does not exist on the host, Docker fails at startup with:

error gathering device information while adding custom_device "/dev/accel/accel0":
no such file or directory

This prevents the stack from running on systems without NPU hardware.

Affected Services

The following services rely on accelerator device exposure:

  • ai-ecg
  • ppg
  • 3dpose-estimation
  • mdpnp
  • patient-monitoring-aggregator (indirect dependency)

Since device mappings are unconditional, containers fail before any CPU fallback can occur.

Workaround

Commenting out the following lines in docker-compose.yaml allows the containers to run on systems without NPU (on an individual troubleshooting level):

# devices:
#   - /dev/dri
#   - /dev/accel
#   - /dev/accel/accel0

After removing these mappings, the stack starts successfully (CPU mode).

Additional Note

Systems with properly configured Intel iGPU drivers (/dev/dri) may not encounter this issue, as OpenVINO can use GPU acceleration. However, on systems without /dev/accel, the current configuration blocks container startup entirely.

There appears to be a mismatch between documentation (NPU optional) and compose configuration (NPU implicitly required).

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions