From 5f8e99f05f40c035b9ac70de646444b08ae95fd7 Mon Sep 17 00:00:00 2001 From: Jash Date: Sun, 30 Aug 2026 01:53:35 +0530 Subject: [PATCH] docs: note the render group for vaapi and qsv decoding fixes #4205 --- docs/installationguide/debian.rst | 18 ++++++++++++++++++ docs/installationguide/ubuntu.rst | 18 ++++++++++++++++++ 2 files changed, 36 insertions(+) diff --git a/docs/installationguide/debian.rst b/docs/installationguide/debian.rst index 8ad326411..6873bcadd 100644 --- a/docs/installationguide/debian.rst +++ b/docs/installationguide/debian.rst @@ -101,6 +101,15 @@ but if you installed from source or the group was not added, run: sudo adduser www-data video +If you plan to use hardware accelerated decoding (``DecoderHWAccelName`` set to +``vaapi`` or ``qsv``), the web server user also needs the ``render`` group. The +render node ``/dev/dri/renderD*`` belongs to ``render`` rather than ``video``, +and without it ZoneMinder logs ``Failed to create hwaccel device``: + +:: + + sudo adduser www-data render + **Step 7:** Tweak Apache configuration :: @@ -211,6 +220,15 @@ but if you installed from source or the group was not added, run: sudo adduser www-data video +If you plan to use hardware accelerated decoding (``DecoderHWAccelName`` set to +``vaapi`` or ``qsv``), the web server user also needs the ``render`` group. The +render node ``/dev/dri/renderD*`` belongs to ``render`` rather than ``video``, +and without it ZoneMinder logs ``Failed to create hwaccel device``: + +:: + + sudo adduser www-data render + **Step 7:** Tweak Apache configuration :: diff --git a/docs/installationguide/ubuntu.rst b/docs/installationguide/ubuntu.rst index 204d9aa49..2322988c5 100644 --- a/docs/installationguide/ubuntu.rst +++ b/docs/installationguide/ubuntu.rst @@ -65,6 +65,15 @@ automatically, but if you installed from source or the group was not added, run: sudo adduser www-data video +If you plan to use hardware accelerated decoding (``DecoderHWAccelName`` set to +``vaapi`` or ``qsv``), the web server user also needs the ``render`` group. The +render node ``/dev/dri/renderD*`` belongs to ``render`` rather than ``video``, +and without it ZoneMinder logs ``Failed to create hwaccel device``: + +:: + + sudo adduser www-data render + You will need to restart ZoneMinder (or reboot) for the group change to take effect. **Step 7:** Configure Apache correctly: @@ -214,6 +223,15 @@ user to the ``video`` group: sudo adduser www-data video +If you plan to use hardware accelerated decoding (``DecoderHWAccelName`` set to +``vaapi`` or ``qsv``), the web server user also needs the ``render`` group. The +render node ``/dev/dri/renderD*`` belongs to ``render`` rather than ``video``, +and without it ZoneMinder logs ``Failed to create hwaccel device``: + +:: + + sudo adduser www-data render + **Step 7:** Configure Apache correctly: ::