starred/ProxmoxVE
1
0
Fork 0
mirror of https://github.com/community-scripts/ProxmoxVE.git synced 2026-07-16 05:34:07 +03:00
Code Issues 23 Packages Projects Releases 44 Wiki Activity

[PR #10579] [CLOSED] Tdarr: NVIDIA GPU Support #8717

New Issue
Closed
opened 2026-02-05 08:40:12 +03:00 by OVERLORD · 0 comments
OVERLORD commented 2026-02-05 08:40:12 +03:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/community-scripts/ProxmoxVE/pull/10579
Author: @ltsch
Created: 1/6/2026
Status: ❌ Closed

Base: main ← Head: feat/tdarr-nvidia-support-v2

📝 Commits (2)

  • 267b2a7 Add merge notice and redirect to upstream
  • a2d2051 feat(tdarr): add NVIDIA GPU support and robust systemd services

📊 Changes

3 files changed (+167 additions, -0 deletions)

View changed files

📝 README.md (+6 -0)
📝 ct/tdarr.sh (+47 -0)
📝 install/tdarr-install.sh (+114 -0)

📄 Description

Tdarr: NVIDIA GPU Support

Summary

Adds NVIDIA GPU hardware acceleration support to Tdarr LXC containers.

Important

This PR prioritizes the native var_gpu and setup_hwaccel for Intel/AMD iGPU support. This PR adds NVIDIA support for /dev/nvidia* devices in addition to the standard /dev/dri interface.

Note

This PR modifies two files: ct/tdarr.sh and install/tdarr-install.sh.

NVIDIA Requirements

GPU Type Device Interface Handled By
Intel/AMD iGPU /dev/dri (render nodes) Native var_gpu + setup_hwaccel
NVIDIA /dev/nvidia* (proprietary) This PR (explicit passthrough + version-matched drivers)

NVIDIA GPU passthrough to LXC containers requires:

  1. Explicit device passthrough — /dev/nvidia* devices are not part of /dev/dri
  2. Exact version matching — Container userspace libraries must match host kernel driver

Without this, applications attempting to use the GPU (e.g., handbrake, ffmpeg) will fail with a Driver/library version mismatch error when attempting to initialize the NVML or CUDA interface.

Core Libraries & Transcoding

The following libraries are matched to the host version to enable hardware acceleration:

Library Role Enables
libcuda1 CUDA Base Communication with GPU hardware
libnvcuvid1 NVDEC Hardware Decoding in FFmpeg/Handbrake
libnvidia-encode1 NVENC Hardware Encoding in FFmpeg/Handbrake
libnvidia-ml1 NVML Device monitoring and temperature/load reporting

Service Management

The PR implements robust systemd service management to ensure reliability and ease of use:

  • tdarr-server.service: Manages the main Tdarr Server. Includes ExecStartPre to automatically run the Tdarr_Updater before every start.
  • tdarr-node.service: Manages the Tdarr Node. Configured with Requires=tdarr-server.service to ensure the correct startup sequence.
  • Auto-Enable: Both services are enabled to start automatically on container boot, replacing the manual or cron-based startup requirement.
  • Configure a server or node: tdarr-node or tdarr-server services can be enabled or disabled per container.

Changes

ct/tdarr.sh (Host-Side)

Change Purpose
NVIDIA detection Identifies driver version to offer optional pinning
Driver pinning Optional apt-mark hold on host to prevent breaking updates
Help/Abort flow Prevents "half-broken" installs if drivers are missing on host
Uses community packages Delegates passthrough logic to build.func natives

install/tdarr-install.sh (Container-Side)

Change Purpose
Autonomous detection Reads /proc/driver/nvidia/version (shared with host)
Version matching Installs libcuda1 etc. pinned to host version
Verification tools Installs nvidia-smi for status monitoring
Systemd Services Configures robust tdarr-server and tdarr-node services
Intel VA-API Optional intel-media-va-driver-non-free for multi-GPU support

Architecture

┌─ ct/tdarr.sh (Proxmox Host) ─────────────────────────────┐
│  1. Detect NVIDIA driver / Pin host drivers (Optional)   │
│  2. Delegate passthrough to build.func (var_gpu="yes")   │
└────────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─ install/tdarr-install.sh (Inside Container) ────────────┐
│  1. Detect driver version directly via /proc             │
│  2. Pin NVIDIA CUDA repo + Install matched packages      │
│  3. Install nvidia-smi for user verification             │
└────────────────────────────────────────────────────────────┘

Testing

  • Verified on Tdarr built on Debian 13 (Trixie) with NVIDIA host driver 590.48
  • Verified on Proxmox 8.4.16/368e3c45c15b895c (running kernel: 6.8.12-17-pve)
  • Confirmed apt correctly prioritizes pinned NVIDIA repo
  • Confirmed services start cleanly

Files Changed

  • ct/tdarr.sh — NVIDIA detection and device passthrough
  • install/tdarr-install.sh — Userspace package installation

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/community-scripts/ProxmoxVE/pull/10579 **Author:** [@ltsch](https://github.com/ltsch) **Created:** 1/6/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `feat/tdarr-nvidia-support-v2` --- ### 📝 Commits (2) - [`267b2a7`](https://github.com/community-scripts/ProxmoxVE/commit/267b2a784569abcd1c37d19adae44a109f72facc) Add merge notice and redirect to upstream - [`a2d2051`](https://github.com/community-scripts/ProxmoxVE/commit/a2d2051e6214f25a0fa34b09142faca7a9e93eba) feat(tdarr): add NVIDIA GPU support and robust systemd services ### 📊 Changes **3 files changed** (+167 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+6 -0) 📝 `ct/tdarr.sh` (+47 -0) 📝 `install/tdarr-install.sh` (+114 -0) </details> ### 📄 Description # Tdarr: NVIDIA GPU Support ## Summary Adds **NVIDIA GPU** hardware acceleration support to Tdarr LXC containers. > [!IMPORTANT] > This PR prioritizes the **native `var_gpu` and `setup_hwaccel`** for Intel/AMD iGPU support. This PR adds NVIDIA support for `/dev/nvidia*` devices in addition to the standard `/dev/dri` interface. > [!NOTE] > This PR modifies **two files**: `ct/tdarr.sh` and `install/tdarr-install.sh`. ## NVIDIA Requirements | GPU Type | Device Interface | Handled By | |----------|-----------------|------------| | Intel/AMD iGPU | `/dev/dri` (render nodes) | Native `var_gpu` + `setup_hwaccel` | | NVIDIA | `/dev/nvidia*` (proprietary) | **This PR** (explicit passthrough + version-matched drivers) | NVIDIA GPU passthrough to LXC containers requires: 1. **Explicit device passthrough** — `/dev/nvidia*` devices are not part of `/dev/dri` 2. **Exact version matching** — Container userspace libraries must match host kernel driver Without this, applications attempting to use the GPU (e.g., handbrake, ffmpeg) will fail with a `Driver/library version mismatch` error when attempting to initialize the NVML or CUDA interface. ### Core Libraries & Transcoding The following libraries are matched to the host version to enable hardware acceleration: | Library | Role | Enables | |---------|------|---------| | `libcuda1` | CUDA Base | Communication with GPU hardware | | `libnvcuvid1` | NVDEC | **Hardware Decoding** in FFmpeg/Handbrake | | `libnvidia-encode1` | NVENC | **Hardware Encoding** in FFmpeg/Handbrake | | `libnvidia-ml1` | NVML | Device monitoring and temperature/load reporting | ### Service Management The PR implements robust systemd service management to ensure reliability and ease of use: - **`tdarr-server.service`**: Manages the main Tdarr Server. Includes `ExecStartPre` to automatically run the `Tdarr_Updater` before every start. - **`tdarr-node.service`**: Manages the Tdarr Node. Configured with `Requires=tdarr-server.service` to ensure the correct startup sequence. - **Auto-Enable**: Both services are enabled to start automatically on container boot, replacing the manual or cron-based startup requirement. - **Configure a server or node**: `tdarr-node` or `tdarr-server` services can be enabled or disabled per container. --- ## Changes ### `ct/tdarr.sh` (Host-Side) | Change | Purpose | |--------|---------| | NVIDIA detection | Identifies driver version to offer optional pinning | | Driver pinning | Optional `apt-mark hold` on host to prevent breaking updates | | Help/Abort flow | Prevents "half-broken" installs if drivers are missing on host | | Uses community packages | Delegates passthrough logic to `build.func` natives | ### `install/tdarr-install.sh` (Container-Side) | Change | Purpose | |--------|---------| | Autonomous detection | Reads `/proc/driver/nvidia/version` (shared with host) | | Version matching | Installs `libcuda1` etc. pinned to host version | | **Verification tools** | **Installs `nvidia-smi` for status monitoring** | | **Systemd Services** | **Configures robust `tdarr-server` and `tdarr-node` services** | | Intel VA-API | Optional `intel-media-va-driver-non-free` for multi-GPU support | --- ## Architecture ``` ┌─ ct/tdarr.sh (Proxmox Host) ─────────────────────────────┐ │ 1. Detect NVIDIA driver / Pin host drivers (Optional) │ │ 2. Delegate passthrough to build.func (var_gpu="yes") │ └────────────────────────────────────────────────────────────┘ │ ▼ ┌─ install/tdarr-install.sh (Inside Container) ────────────┐ │ 1. Detect driver version directly via /proc │ │ 2. Pin NVIDIA CUDA repo + Install matched packages │ │ 3. Install nvidia-smi for user verification │ └────────────────────────────────────────────────────────────┘ ``` --- ## Testing - Verified on Tdarr built on Debian 13 (Trixie) with NVIDIA host driver 590.48 - Verified on Proxmox 8.4.16/368e3c45c15b895c (running kernel: 6.8.12-17-pve) - Confirmed `apt` correctly prioritizes pinned NVIDIA repo - Confirmed services start cleanly --- ## Files Changed - `ct/tdarr.sh` — NVIDIA detection and device passthrough - `install/tdarr-install.sh` — Userspace package installation --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
OVERLORD added the pull-request label 2026-02-05 08:40:12 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Implemented in VED waiting push to Main
breaking change
bug
bug
bugfix
deferred
delete script
dependencies
enhancement
external
feature
github
help wanted
in project pipeline
invalid
investigation
json
maintenance
needs triage
new script
new script
nice to have
not a script issue
not planned
organization
pull-request
Mirrored from GitHub Pull Request
 question
refactor
rename script
security
update script
website
wontdo
🛑 Failure to comply with the guidelines
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
OVERLORD
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/ProxmoxVE#8717
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?