Skip to content

feat(qsv): document and expose Intel /dev/dri device passthrough #610

Description

@cursor

Goal

Opt-in Docker Compose / docs so operators can pass /dev/dri (Intel Quick Sync / VAAPI render node) into the StreamDL client container.

Context

Parent epic: #452

This is Phase 1 of Quick Sync support. Device passthrough alone does not enable QSV with the current mwader/static-ffmpeg client image — that lands in #608. This issue only makes the ops surface honest and ready.

Scope

  • Extend docker-compose.yml.example with a commented, opt-in devices: (+ optional group_add for video/render) on the client service
  • README: host prerequisites (/dev/dri/renderD*), finding GIDs, PUID/PGID interaction, and clear note that a QSV-capable FFmpeg is still required (feat(qsv): optional client image with Quick Sync / VAAPI-capable FFmpeg #608)
  • No Dockerfile / default behavior change

Out of scope

Depends on

Blocks

Acceptance

  • Compose example documents opt-in /dev/dri passthrough
  • README covers host setup and limitations with static FFmpeg
  • Default install path unchanged (no required devices)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions