immich-machine-learning

immich-machine-learning

Docker app from sgraaf's Repository

Overview

Machine-learning service for Immich (face recognition, smart search, etc). This is the "immich-machine-learning" service from the official Immich docker-compose.yml. It must be on the same custom Docker network ("immich") as the Immich server, which reaches it at http://immich-machine-learning:3003 via the IMMICH_MACHINE_LEARNING_URL setting. It exposes port 3003 only on the internal network (no host port published). For hardware-accelerated inference, switch the repository tag to one of: release-armnn, release-cuda, release-rocm, release-openvino, release-rknn, and add the relevant device(s) - see https://docs.immich.app/features/ml-hardware-acceleration.


License: AGPLv3 Discord

High performance self-hosted photo and video management solution



Català Español Français Italiano 日本語 한국어 Deutsch Nederlands Türkçe 简体中文 正體中文 Українська Русский Português Brasileiro Svenska العربية Tiếng Việt ภาษาไทย മലയാളം

[!WARNING] ⚠️ Always follow 3-2-1 backup plan for your precious photos and videos!

[!NOTE] You can find the main documentation, including installation guides, at https://immich.app/.

Links

Demo

Access the demo here. For the mobile app, you can use https://demo.immich.app for the Server Endpoint URL.

Login credentials

Email Password
demo@immich.app demo

Features

Features Mobile Web
Upload and view videos and photos Yes Yes
Auto backup when the app is opened Yes N/A
Prevent duplication of assets Yes Yes
Selective album(s) for backup Yes N/A
Download photos and videos to local device Yes Yes
Multi-user support Yes Yes
Album and Shared albums Yes Yes
Scrubbable/draggable scrollbar Yes Yes
Support raw formats Yes Yes
Metadata view (EXIF, map) Yes Yes
Search by metadata, objects, faces, and CLIP Yes Yes
Administrative functions (user management) No Yes
Background backup Yes N/A
Virtual scroll Yes Yes
OAuth support Yes Yes
API Keys N/A Yes
LivePhoto/MotionPhoto backup and playback Yes Yes
Support 360 degree image display No Yes
User-defined storage structure Yes Yes
Public Sharing Yes Yes
Archive and Favorites Yes Yes
Global Map Yes Yes
Partner Sharing Yes Yes
Facial recognition and clustering Yes Yes
Memories (x years ago) Yes Yes
Offline support Yes No
Read-only gallery Yes Yes
Stacked Photos Yes Yes
Tags No Yes
Folder View Yes Yes

Translations

Read more about translations here.

Translation status

Repository activity

Activities

Star history

Star History Chart

Contributors

Install immich-machine-learning on Unraid in a few clicks.

Find immich-machine-learning in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for immich-machine-learning Review the template variables and paths Click Install

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/immich-app/immich-machine-learning:release
Last Updated2026-07-17
First Seen2026-05-25

Runtime arguments

Network
immich

Template configuration

Model cachePathrw

Stores downloaded ML models so they are not re-downloaded on every restart. Equivalent to the named volume 'model-cache' in the compose file.

Target
/cache
Default
/mnt/user/appdata/immich/model-cache
Value
/mnt/user/appdata/immich/model-cache
TimezoneVariable

Optional timezone, e.g. Europe/Amsterdam or Etc/UTC.

Target
TZ
Default
Europe/Amsterdam
Value
Europe/Amsterdam