Skip to content

Commit 5e7dc9c

Browse files
Document Ubuntu :cuda GPU snapshots (#65)
* Document Ubuntu :cuda GPU snapshots and host toolkit setup. Co-authored-by: Cursor <cursoragent@cursor.com> * Point GPU snapshots at the CUDA image, not the Ubuntu alias. Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent df4a91c commit 5e7dc9c

1 file changed

Lines changed: 21 additions & 1 deletion

File tree

‎docs/pages/client/install.md‎

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ This project builds automatically in [Docker Cloud](https://hub.docker.com/r/gol
155155
and creates [ready-to-use multi-architecture images](https://hub.docker.com/r/golift/notifiarr/tags).
156156
The `latest` tag is always a tagged release in GitHub.
157157
It also builds in a GitHub Action and publishes to GHCR (`ghcr.io/notifiarr/notifiarr`).
158-
A CUDA-enabled image is available for Nvidia GPU monitoring: `ghcr.io/notifiarr/notifiarr:cuda`.
158+
A CUDA-tagged image is available for Nvidia GPU monitoring: `ghcr.io/notifiarr/notifiarr:cuda` (Ubuntu base with NVIDIA Container Toolkit env; not `nvidia/cuda`).
159159

160160
### Compose
161161

@@ -202,6 +202,26 @@ docker run --hostname $(hostname) -d --privileged \
202202
docker logs <container id from docker run>
203203
```
204204

205+
### Nvidia GPU snapshots
206+
207+
GPU snapshots run `nvidia-smi` on the host. The client does **not** use the CUDA toolkit, so you do not install a CUDA toolkit version in the container.
208+
209+
1. Install NVIDIA drivers and the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) on the **host**.
210+
1. Use the CUDA image: `golift/notifiarr:cuda` (same on `ghcr.io/notifiarr/notifiarr`). Alpine `latest` is not recommended (`nvidia-smi` is a glibc binary). The plain `:ubuntu` image does not set `NVIDIA_VISIBLE_DEVICES`.
211+
1. Pass the GPU into the container. Do not install CUDA inside the image.
212+
213+
```bash
214+
docker run --name Notifiarr -h notifiarr --restart unless-stopped \
215+
--gpus all --privileged -p 5454:5454 \
216+
-v /path/to/notifiarrconfig/:/config \
217+
-v /var/run/utmp:/var/run/utmp -v /etc/machine-id:/etc/machine-id \
218+
golift/notifiarr:cuda
219+
```
220+
221+
Compose equivalent: set `image: golift/notifiarr:cuda` and `gpus: all`. See the commented example in [`examples/compose.yml`](https://github.com/Notifiarr/notifiarr/blob/main/examples/compose.yml).
222+
223+
If an older `:cuda` image fails with `nvidia-container-cli: requirement error: unsatisfied condition: cuda>=...`, the host driver is older than that image's CUDA base. Current `:cuda` images are Ubuntu-based and do not set that constraint. Pull a new image.
224+
205225
## Home Assistant OS
206226
207227
!!! warning "Home Assistant OS Users"

0 commit comments

Comments
 (0)