# immich

High performance self-hosted photo and video management solution.

- Replaces: not recorded
- Stack: postgres (database)
- Deployment: docker_compose
- License: AGPL-3.0 (osi) [source](https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/LICENSE)
- Business model: unknown. Not checked by the pipeline. Read the project's own pricing or docs page before setting this.
- Difficulty: hard. 4 services (2 database or broker: valkey, postgres), 4 volume mounts, 6 env values to set, no elevated host access. Heuristic score 8 of 11: hard.
- Requirements: not stated
- Repository: [immich-app/immich](https://github.com/immich-app/immich)

## Install

1. Save the compose file as docker-compose.yml ([source](https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/docker/docker-compose.yml))

   ```yaml
   #
   # WARNING: To install Immich, follow our guide: https://docs.immich.app/install/docker-compose
   #
   # Make sure to use the docker-compose.yml of the current release:
   #
   # https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
   #
   # The compose file on main may not be compatible with the latest release.
   
   name: immich
   
   services:
     immich-server:
       container_name: immich_server
       image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
       # extends:
       #   file: hwaccel.transcoding.yml
       #   service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
       volumes:
         # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
         - ${UPLOAD_LOCATION}:/data
         - /etc/localtime:/etc/localtime:ro
       env_file:
         - .env
       ports:
         - '2283:2283'
       depends_on:
         - redis
         - database
       restart: always
       healthcheck:
         disable: false
   
     immich-machine-learning:
       container_name: immich_machine_learning
       # For hardware acceleration, add one of -[armnn, cuda, rocm, openvino, rknn] to the image tag.
       # Example tag: ${IMMICH_VERSION:-release}-cuda
       image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
       # extends: # uncomment this section for hardware acceleration - see https://docs.immich.app/features/ml-hardware-acceleration
       #   file: hwaccel.ml.yml
       #   service: cpu # set to one of [armnn, cuda, rocm, openvino, openvino-wsl, rknn] for accelerated inference - use the `-wsl` version for WSL2 where applicable
       volumes:
         - model-cache:/cache
       env_file:
         - .env
       environment:
         MACHINE_LEARNING_MODEL_REVISION: v2
       restart: always
       healthcheck:
         disable: false
   
     redis:
       container_name: immich_redis
       image: docker.io/valkey/valkey:9@sha256:418652cfb58ef879d4978c33553735d7147016032d5aefaa14c828e611eb9dfd
       healthcheck:
         test: redis-cli ping | grep -q PONG || exit 1
       restart: always
   
     database:
       container_name: immich_postgres
       image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a8416db519b40b1c23
       environment:
         POSTGRES_PASSWORD: ${DB_PASSWORD}
         POSTGRES_USER: ${DB_USERNAME}
         POSTGRES_DB: ${DB_DATABASE_NAME}
         POSTGRES_INITDB_ARGS: '--data-checksums'
         # Uncomment the DB_STORAGE_TYPE: 'HDD' var if your database isn't stored on SSDs
         # DB_STORAGE_TYPE: 'HDD'
       volumes:
         # Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LOCATION in the .env file
         - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
       shm_size: 128mb
       restart: always
       healthcheck:
         disable: false
   
   volumes:
     model-cache:
   ```

Compose file check: not run.

## Gotchas and maintenance

### Gotchas

- Update: Update ([source](https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 719
- Stars: 116865, forks: 7295
- Last push: 2026-10-21 (0 days ago)
- Latest release: none recorded

## Sources

- [Repository: https://github.com/immich-app/immich](https://github.com/immich-app/immich)
- [License: https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/LICENSE](https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/LICENSE)
- [Compose file: https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/docker/docker-compose.yml](https://github.com/immich-app/immich/blob/745bdd2edf72ce0f75e748e2d68c37b6ea196cc5/docker/docker-compose.yml)
- [Note: https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml](https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml)

---
Canonical: https://openlogs.fyi/tools/immich  
Last updated: 2026-10-22