Immich photo management with CUDA ML backend for face recognition and smart search. Includes PostgreSQL, Redis, and the immich-ml service. MUST be invoked before building, deploying, configuring, or troubleshooting the immich-ml image.
Immich photo management with GPU-accelerated machine learning for face recognition and smart search.
| Property | Value |
|---|---|
| Base | fedora |
| Layers | agent-forwarding, nodejs24, cuda, python-ml, supervisord, postgresql, vectorchord, redis, immich, immich-ml |
| Platforms | linux/amd64 |
| Ports | 2283 |
| Registry | ghcr.io/overthinkos |
fedora (quay.io/fedora/fedora:43)pixi → python → supervisord (transitive)nodejs24 — Node.js 24 runtimecuda — CUDA toolkit, cuDNNpython-ml — ML Python environmentpostgresql — database on :5432vectorchord — VectorChord vector similarity extensionredis — cache on :6379immich — Immich server on :2283immich-ml — ML backend on :3003| Port | Service | Protocol |
|---|---|---|
| 2283 | Immich web UI + API | HTTP |
| Name | Path | Purpose |
|---|---|---|
| library | ~/.immich/library | Photo/video storage |
| cache | ~/.immich/cache | Thumbnail cache |
| import | ~/.immich/import | Photo import directory |
| external | ~/.immich/external | External library (no-copy) |
| pgdata | ~/.postgresql | PostgreSQL data |
| models | ~/.immich/models | ML models |
ov image build immich-ml
ov config setup immich-ml
ov start immich-ml
# Open http://localhost:2283
/ov-layers:immich — Immich server, db init, library/cache volumes/ov-layers:immich-ml — ML backend for face recognition and smart search/ov-layers:cuda — GPU support/ov-layers:python-ml — ML Python environment/ov-layers:postgresql — database backend/ov-layers:vectorchord — VectorChord for smart search/ov-layers:redis — session/cache backend/ov-images:immich — CPU-only (no ML, no face recognition)/ov-images:nvidia — GPU base without ImmichAfter ov start:
ov status immich-ml — container runningov service status immich-ml — all services RUNNINGcurl -s -o /dev/null -w '%{http_code}' http://localhost:2283 — Immich HTTP returns 200curl -s -o /dev/null -w '%{http_code}' http://localhost:3003 — ML backend HTTP returns 200MUST be invoked when the task involves the immich-ml image, Immich ML features, or GPU-accelerated photo management. Invoke this skill BEFORE reading source code or launching Explore agents.