Merge pull request #2890 from alexbelgium/fix/claude-desktop-low-resource

Reduce Claude Desktop resource usage and enable Intel N150 acceleration

claude_desktop/CHANGELOG.md

@@ -1,4 +1,8 @@
- 
+## 1.34 (22-07-2026)
+
+- Reduce idle and active remote-desktop overhead without changing Claude Desktop, Claude Code, GPU acceleration, Headroom, RTK, or TokenSave behavior. Selkies now defaults to 15 FPS instead of 30 FPS, uses browser-rendered cursors, and disables unused audio, microphone, gamepad, second-screen, and collaborative-sharing channels. All settings remain overridable through `env_vars` for installations that need those features.
+- Explicitly install and build-validate the Intel userspace graphics stack in the amd64 image for Intel N150/Twin Lake and other modern Intel iGPUs: `intel-media-va-driver` for VA-API encoding/decoding, `libgl1-mesa-dri` for the Mesa Iris OpenGL driver, `mesa-vulkan-drivers` for Intel Vulkan, and `vainfo` for runtime diagnostics. The host-provided `i915` kernel driver and existing `/dev/dri` device mapping remain unchanged.
+
 ## 1.33 (22-07-2026)
 
 - Add cowork virtualization support: `qemu-system-x86` and `ovmf` (Bookworm main, installed via apt) plus `virtiofsd` for sharing the workspace into the sandbox microVM. `virtiofsd` is only packaged for Debian trixie/sid, not Bookworm or bookworm-backports, and its trixie `.deb` links a newer GLIBC than this add-on's Bookworm runtime — so it now gets built from the pinned crates.io release (`1.14.0`) in a dedicated `virtiofsd-builder` stage, the same GLIBC-safe pattern already used for `rtk` and `tokensave`. Its build deps (`libseccomp-dev`, `libcap-ng-dev`, `pkg-config`, `clang`, `libclang-dev`) live only in that builder stage; only the runtime shared libs (`libseccomp2`, `libcap-ng0`) ship in the final image. The built binary is validated with `--version` at build time alongside `rtk`/`tokensave`, so a GLIBC/ABI mismatch fails the image build instead of surfacing at container start. Docker itself is deliberately not installed: this base image already ships Docker-in-Docker (`docker-ce`/`containerd.io` from Docker's own apt repo, started via the pre-existing `START_DOCKER` env var) — an initial attempt to also `apt-get install docker.io` broke the build, since Debian's package pulls in `containerd`/`runc`, which apt refuses to install alongside the base image's already-installed `containerd.io` (`Conflicts`).

claude_desktop/Dockerfile

@@ -138,6 +138,25 @@ RUN install -d -m 0755 /etc/apt/keyrings && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
+# The Intel N150/Twin Lake iGPU uses the host's i915 kernel driver through the mapped
+# /dev/dri nodes. Explicitly install the amd64 userspace stack needed for accelerated
+# OpenGL rendering, VA-API video encoding, and Vulkan, then fail the build if any driver
+# payload is missing. Keep aarch64 unchanged because these Intel packages are amd64-only.
+RUN if [[ "${TARGETARCH}" == "amd64" ]]; then \
+        apt-get update && \
+        apt-get install -y --no-install-recommends \
+            intel-media-va-driver-non-free \
+            libgl1-mesa-dri \
+            mesa-vulkan-drivers \
+            vainfo && \
+        test -f /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so && \
+        test -f /usr/lib/x86_64-linux-gnu/dri/iris_dri.so && \
+        test -f /usr/share/vulkan/icd.d/intel_icd.x86_64.json && \
+        command -v vainfo > /dev/null; \
+    fi && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
 # Install the current upstream hadolint and actionlint releases for both supported
 ARG HADOLINT_VERSION=v2.14.0
 ARG ACTIONLINT_VERSION=v1.7.12

claude_desktop/config.yaml

@@ -17,7 +17,13 @@ environment:
   HOME: /data/data
   PGID: "1000"
   PUID: "1000"
-  SELKIES_FRAMERATE: "30"
+  SELKIES_AUDIO_ENABLED: "false"
+  SELKIES_ENABLE_SHARING: "false"
+  SELKIES_FRAMERATE: "15"
+  SELKIES_GAMEPAD_ENABLED: "false"
+  SELKIES_MICROPHONE_ENABLED: "false"
+  SELKIES_SECOND_SCREEN: "false"
+  SELKIES_USE_BROWSER_CURSORS: "true"
   START_DOCKER: "false"
   TITLE: Claude Desktop
 image: ghcr.io/alexbelgium/claude_desktop-{arch}
@@ -112,5 +118,5 @@ slug: claude_desktop
 tmpfs: true
 udev: true
 url: https://github.com/alexbelgium/hassio-addons
-version: "1.33"
+version: "1.34"
 video: true