Immich provides self-hosted photo and video management with machine-learning assisted tagging. This stack bundles the core server, machine-learning service, Redis cache, vector-enabled Postgres database, and the Omoide utility container for bulk processing.【F:immich_base/compose.yml†L1-L82】
backend_net to communicate with each other while remaining isolated from the public edge.【F:immich_base/compose.yml†L17-L80】${UPLOAD_LOCATION} is mounted into the server and Omoide; database data resides in ${DB_DATA_LOCATION}; models cache to model-cache.【F:immich_base/compose.yml†L20-L75】/dev/dri for transcoding and machine-learning inference.【F:immich_base/compose.yml†L5-L37】| Service | Role |
|---|---|
| immich-server | Core API/UI handling uploads, metadata, and background jobs. |
| immich-machine-learning | Performs facial recognition and other ML tasks. |
| immich_redis | Redis cache supporting job queues and sessions. |
| immich_postgres | Vector-enabled PostgreSQL storing metadata and embeddings. |
| omoide | Utility worker for batch media processing and metadata cleanup. |
model-cache, database, and upload directories via Autorestic or another restic job; these are not automatically captured in other stacks.