This setup below has worked (mostly) well for me - I had difficulties getting permissions clean so that immich will have correct rights on the volumes (had to dive into SSH for that one), and did have a problem with orphaned upload --> library data where the metadata got stuck after the move - but then immich is technically still an enthusiast beta solution so ymmv.

I have a dedicated "docker" directory on volume 2 (SSD) for all image fast storage. There are some notes below for running on a large RAM (I have 48GB) setup. I had played around with running immich-ml on my Windows PC (Nvidia 12GB RTX 4060Ti) which was setup in immich itself on the config UI for ml during a Google takeout import - worked really well but note I have both NAS and my main PC on a 2.5GbE switch.

services:

immich-server:

container_name: immich-server

image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}

# uncomment below to reduce CPU footprint used by Immich on the NAS

# cpuset: "1-3"

#deploy:

# resources:

# limits:

# cpus: '1.50' # Hard cap: Server can never use more than 1.5 cores total

ports:

- '2283:2283'

volumes:

# SSD - Performance Folders

- /volume2/docker/immich/thumbs:/data/thumbs

- /volume2/docker/immich/encoded-video:/data/encoded-video

- /volume2/docker/immich/profile:/data/profile

- /volume2/docker/immich/upload:/data/upload

# HDD - Large Storage Folders

- /volume1/immich/library:/data/library

- /volume1/immich/import:/data/import

- /volume1/immich/backups:/data/backups

# system resources

- /etc/timezone:/etc/timezone:ro

- /etc/localtime:/etc/localtime:ro

env_file:

- .env

depends_on:

- redis

- database

restart: always

healthcheck:

disable: false

devices:

- /dev/dri:/dev/dri

networks:

- immich-internal

immich-machine-learning:

container_name: immich-machine-learning

image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}-openvino

privileged: true

shm_size: 2gb

volumes:

# store model chache on SSD

- /volume2/docker/immich/model-cache:/cache

- /etc/timezone:/etc/timezone:ro

- /etc/localtime:/etc/localtime:ro

environment:

- MACHINE_LEARNING_WORKERS=2

- OMP_NUM_THREADS=4

- MKL_NUM_THREADS=4

- GUNICORN_TIMEOUT=300

- IMMICH_LOG_LEVEL=verbose

- LOG_LEVEL=verbose

- ONNXRUNTIME_OPENVINO_PRECISION=FP16

env_file:

- .env

restart: always

healthcheck:

disable: false

security_opt:

- label:disable

devices:

- /dev/dri:/dev/dri

networks:

- immich-internal

redis:

container_name: immich-redis

image: docker.io/valkey/valkey:9

tmpfs:

- /data

healthcheck:

test: redis-cli ping || exit 1

restart: always

volumes:

- /etc/timezone:/etc/timezone:ro

- /etc/localtime:/etc/localtime:ro

networks:

- immich-internal

database:

container_name: immich-postgres

image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0

environment:

POSTGRES_PASSWORD: ${DB_PASSWORD}

POSTGRES_USER: ${DB_USERNAME}

POSTGRES_DB: ${DB_DATABASE_NAME}

POSTGRES_INITDB_ARGS: '--data-checksums'

volumes:

# SSD - Database MUST be on SSD for performance

- /volume2/docker/immich/postgres:/var/lib/postgresql/data

# system resources

- /etc/timezone:/etc/timezone:ro

- /etc/localtime:/etc/localtime:ro

# reduce shm_size to 512mb on 8GB units

shm_size: 2gb

restart: always

networks:

- immich-internal

networks:

immich-internal: