Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Immich machine learning

Featured Replies

Hi all,

 

i want to use Immich on my Unraid Server but I can't find any "machine learning" docker for Immich. How I can use the "machine learning" part locally on my Intel NUC?

 

Thank you and Regards
Luk

  • Community Expert

the machine learning sytem is built into immich.

immch maintainers want us to use the docker compose plugin to run on unraid:
https://immich.app/docs/install/unraid/

 

space invader has made CA unraid docker tempaltes.
You will need to run

image.png.c0b28fcef6b79c0d3472009bbfe457af.png

image.png.c92756e7b2026a95db46fc39294027b1.png

 

its scattered on the forum but i've assisted other with setting up immich.

I'm currently running it with a nvidia and use the buffal_s modle for face detection.

The redis docker mod is broken and breaks when immich has updates.


Machine learning is possible via the setting once its up and running:
image.thumb.png.b4447822746a9de038cab4be659098d0.png

 

If you don't want to self-host the machine learning you will need to use the docker compose version and setup a remote access to something like chatgpt / openai for your instance
https://immich.app/docs/guides/remote-machine-learning/

  • 2 weeks later...

@bmartino1 is it better to run a redis container versus using docker-mods? 

 

Additionally, would you be able to share your immich container settings because I swear I have them set up appropriately, but nvidia-smi in immich console is blank. 

 

 

 

 

IMG_0085.png

IMG_0084.png

IMG_0083.png

IMG_0082.jpeg

  • Community Expert

I had issues with immich updates and runign the docker mod. it is better to run a seperate redis container.

  • Community Expert

extra parmaerter:
 

--runtime=nvidia --hostname immich.home.arpa --device=/dev/dri:/dev/dri

added nvidia stuff:

 

Advance toggle more setting:
this docker runs as nobody:users with a umask of 022

image.png.e28e5a238b49f311fe5a77ba7b66326d.png

 

Machine Learning and G-Card at bottom:

image.png.6a074f093bafbbc97c6d09a4e29b0955.png


Redis info:

image.png.23596813535a449ce854a393af5aab32.png

 

Postgress info:
image.png.add0614b443a79b2dceb9ba4565a7197.png

 

Immich settings / volumes:

image.png.212dcfa887630adf3de2f0508b18f6fd.png

 

using repository - docker tag:

ghcr.io/imagegenius/immich


 

Thank you so much, I'll check it out and fingers crossed my GPU can start carrying its load :D

  • Community Expert

if the g card is being used by other containers, you may need to edit immich machine learning settings and move to a smaller ai. I found success with buffalo_s for facial recognition.

 

check the log for dns / ai grab and memory error:

edit immich settings:

profile > administration:

 

 

settings at the left:

image.png.1b1a2837a25d183384f21c57eff63bd2.png

 

Machine learning:

image.thumb.png.7d76ed593d2b40998cbe6898f7269cee.png

Facial Recognition:

...

Review:

https://immich.app/docs/features/facial-recognition/

 

more info on how and what models are used:

https://pypi.org/project/insightface/0.7/

 

image.png.024a2f73801403d13d19120168163efc.png

 

Edited by bmartino1
PI delete

  • 2 weeks later...

Hey @bmartino1,

I've followed your guide here exactly but my CPU seems to still be the one running the ML models here while my GPU sits idle.

Just to confirm, for your docker image repository and tag, which version are you using?

ghcr.io/imagegenius/immich

or 

ghcr.io/imagegenius/immich:cuda

 

Edited by mykal.codes
clarification

  • Community Expert

ghcr.io/imagegenius/immich

 

which is the latest tag. It uses cpu and the nvidia card the machine learning is more setting within immich and another docker...

https://immich.app/docs/guides/remote-machine-learning/

 

you would want to run cuda version to use nvidia exclusively.

  • 9 months later...

Hi, sorry to resurrect this, but aside from pointing the container to the host's /dev/dri , what arguments would be needed on the Intel side?

Must one specifically use the 'openvino' tag to retrieve an Intel-specific image from Imagegenius's repo, or does the 'latest' tag include all versions (cuda, openvino, noml)?

My preferred hardware device appears to be set correctly:

--runtime=nvidia --hostname immich.home.arpa --device=/dev/dri:/dev/dri

image.png

EDIT: I think I've found the solution for Intel and openvino:

These are the parameters: --device=/dev/dri --device-cgroup-rule='c 189:* rmw' -v /dev/bus/usb:/dev/bus/usb

And, the repo should have the latest openvino tag: ghcr.io/imagegenius/immich:openvino

Edited by floepie05
To update

  • 1 month later...

Could you, please help me? Hardware transcoding works - I see a load on my 1050ti, but all machine learning tasks a still processed on the CPU. What am I doing wrong?

Dock.png

Gluk-UpdateContainer.png

System-Settings-Immich.png

Gluk-Dashboard.png

Edited by DarkP

On 2/15/2026 at 6:26 AM, bmartino1 said:

when isntalling CA are you installing the cuda version?

I've installed Default version. Need to install Cuda version?

  • Community Expert
3 hours ago, DarkP said:

I've installed Default version. Need to install Cuda version?

If using the ca, you need to install the cuda version. That's because the default Docker does not have the drivers.

Similar back with any other system you need to install the drivers to use that device. The default does not have the graphics drivers installed. That's why you need to install the appropriate Docker based on your hardware...

On 2/19/2026 at 8:32 PM, bmartino1 said:

If using the ca, you need to install the cuda version. That's because the default Docker does not have the drivers.

Similar back with any other system you need to install the drivers to use that device. The default does not have the graphics drivers installed. That's why you need to install the appropriate Docker based on your hardware...

Many thanks! It works now!

1111.png

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.