Skip to content

Step 7: Machine Learning Setup

The ML service handles face recognition, CLIP-based image search, and OCR. Models are downloaded on first use and cached (several GB).

Quicklink to add a new Docker container (paste into your browser while logged into Unraid):

http://<your-unraid-ip>/Docker/AddContainer
  1. Go to the Docker tab → Add Container
  2. Select the immich-machine-learning template matching your GPU (see Step 3)
  3. Configure:
    • Network: immich_internal
    • Path: Model Cache: /mnt/user/appdata/immich/model-cache/ (default is fine as long as it points to a path with an SSD/NVMe for better performance)
  4. Hit Apply to start the container.

Note

  • The first startup will be slow as ML models are downloaded. This is normal.
  • You don't need to set a port. See FAQ.