nvidia-patch/README.md

107 lines
4.6 KiB
Markdown
Raw Normal View History

2017-02-12 15:16:29 +00:00
# nvidia-patch
2017-02-12 15:17:05 +00:00
2018-12-28 14:52:20 +00:00
This patch removes restriction on maximum number of simultaneous NVENC video encoding sessions imposed by Nvidia to consumer-grade GPUs.
2017-11-01 13:37:03 +00:00
2019-01-07 22:50:10 +00:00
Main target operating system is GNU/Linux, but for experimental Windows support see [win](win).
Requirements:
- x86\_64 system architecture
- ubuntu (< 18.04 for 375.39 nvidia driver or kernel < 4.15). Also known to work on Debian and CentOS, but not tested widely.
- nvenc-compatible gpu (https://developer.nvidia.com/video-encode-decode-gpu-support-matrix#Encoder)
- Nvidia driver. Patch availible for:
- [375.39](https://download.nvidia.com/XFree86/Linux-x86_64/375.39/NVIDIA-Linux-x86_64-375.39.run)
2019-01-19 17:35:33 +00:00
- [390.77](https://download.nvidia.com/XFree86/Linux-x86_64/390.77/NVIDIA-Linux-x86_64-390.77.run)
- [390.87](https://download.nvidia.com/XFree86/Linux-x86_64/390.87/NVIDIA-Linux-x86_64-390.87.run)
- [396.24](https://download.nvidia.com/XFree86/Linux-x86_64/396.24/NVIDIA-Linux-x86_64-396.24.run)
2019-01-10 17:54:43 +00:00
- [396.26](https://international.download.nvidia.com/tesla/396.26/NVIDIA-Linux-x86_64-396.26.run)
- [396.37](https://international.download.nvidia.com/tesla/396.37/NVIDIA-Linux-x86_64-396.37.run)
- [396.54](https://download.nvidia.com/XFree86/Linux-x86_64/396.54/NVIDIA-Linux-x86_64-396.54.run)
- 410.48
- [410.57](https://download.nvidia.com/XFree86/Linux-x86_64/410.57/NVIDIA-Linux-x86_64-410.57.run)
- [410.73](https://download.nvidia.com/XFree86/Linux-x86_64/410.73/NVIDIA-Linux-x86_64-410.73.run)
- [410.78](https://download.nvidia.com/XFree86/Linux-x86_64/410.78/NVIDIA-Linux-x86_64-410.78.run)
2019-01-10 17:54:43 +00:00
- [410.79](https://international.download.nvidia.com/tesla/410.79/NVIDIA-Linux-x86_64-410.79.run)
- [410.93](https://download.nvidia.com/XFree86/Linux-x86_64/410.93/NVIDIA-Linux-x86_64-410.93.run)
- [415.18](https://download.nvidia.com/XFree86/Linux-x86_64/415.18/NVIDIA-Linux-x86_64-415.18.run)
- [415.25](https://download.nvidia.com/XFree86/Linux-x86_64/415.25/NVIDIA-Linux-x86_64-415.25.run)
- [415.27](https://download.nvidia.com/XFree86/Linux-x86_64/415.27/NVIDIA-Linux-x86_64-415.27.run)
- [418.30](https://download.nvidia.com/XFree86/Linux-x86_64/418.30/NVIDIA-Linux-x86_64-418.30.run)
2018-05-24 13:41:56 +00:00
Tested on Ubuntu 18.04 LTS (GNU/Linux 4.15.0-23-generic x86\_64)
2017-11-01 13:37:03 +00:00
2019-01-05 12:49:13 +00:00
## Synopsis
```
# bash ./patch.sh -h
SYNOPSIS
patch.sh [OPTION]...
DESCRIPTION
The patch for Nvidia drivers to increase encoder sessions
-s Silent mode (No output)
-r Rollback to original (Restore lib from backup)
-h Print this help message
```
## Step-by-Step guide
Examples are provided for driver version 410.78. All commands are runned as root.
### Download driver
2019-01-05 12:49:13 +00:00
[https://download.nvidia.com/XFree86/Linux-x86\_64/410.78/NVIDIA-Linux-x86\_64-410.78.run](https://download.nvidia.com/XFree86/Linux-x86_64/410.78/NVIDIA-Linux-x86_64-410.78.run)
2019-01-05 12:49:13 +00:00
### Install driver
2017-11-01 14:03:02 +00:00
```bash
mkdir /opt/nvidia && cd /opt/nvidia
wget https://download.nvidia.com/XFree86/Linux-x86_64/410.78/NVIDIA-Linux-x86_64-410.78.run
chmod +x ./NVIDIA-Linux-x86_64-410.78.run
./NVIDIA-Linux-x86_64-410.78.run
2017-11-01 13:40:23 +00:00
```
2017-11-01 13:37:03 +00:00
### Check driver
2019-01-05 12:49:13 +00:00
2017-11-01 14:03:02 +00:00
```bash
2017-11-01 13:37:03 +00:00
nvidia-smi
```
2017-11-01 13:37:03 +00:00
2019-01-05 12:49:13 +00:00
Output should show no errors and details about your driver and GPU.
### Patch driver
This patch performs backup of original file prior to making changes.
```bash
bash ./patch.sh
```
2017-11-01 13:37:24 +00:00
2019-01-05 12:49:13 +00:00
You're all set!
## Rollback
If something got broken you may restore patched driver from backup:
2017-11-01 13:37:24 +00:00
```bash
bash ./patch.sh -r
2017-11-01 13:40:23 +00:00
```
2017-02-12 15:17:05 +00:00
2017-11-01 14:03:39 +00:00
## See also
2019-02-10 09:18:35 +00:00
* Plex Media Server: enable HW **decoding**:
* [GH Issue](https://github.com/keylase/nvidia-patch/issues/51)
* PMS Forum:
1. [https://forums.plex.tv/t/hardware-accelerated-decode-nvidia-for-linux/233510/158](https://forums.plex.tv/t/hardware-accelerated-decode-nvidia-for-linux/233510/158)
2. [https://forums.plex.tv/t/hardware-accelerated-decode-nvidia-for-linux/233510/172](https://forums.plex.tv/t/hardware-accelerated-decode-nvidia-for-linux/233510/172)
2019-02-11 15:38:37 +00:00
* Unraid / Docker
* [GH Issue](https://github.com/keylase/nvidia-patch/issues/43)
* Unraid Nvidia plugin:
* [Repo](https://github.com/linuxserver/Unraid-Nvidia-Plugin)
* [Forum page](https://forums.unraid.net/topic/77813-plugin-linuxserverio-unraid-nvidia/) ([archive link](https://web.archive.org/web/20190211145338/https://forums.unraid.net/topic/77813-plugin-linuxserverio-unraid-nvidia/))
2019-02-10 09:18:35 +00:00
* [Original research behind this patch (in Russian)](https://habr.com/post/262563/)
If you experience `CreateBitstreamBuffer failed: out of memory (10)`, then you have to lower buffers number used for every encoding session. If you are using `ffmpeg`, see option `-surfaces` ("Number of concurrent surfaces") and try value near `-surfaces 8`.