Table of Contents

My Immich Setup
#

This Immich setup runs in a Docker container to provide a self-hosted photo and video management solution. It includes essential services such as the Immich server, machine learning module, Redis, and PostgreSQL database.

My Docker Compose Configuration
#

name: immich
services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    user: "${IMMICH_UID}:${IMMICH_GID}"
    # 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
      # 1. Main System Folder (SSD)
      - ${UPLOAD_LOCATION}:/data
      # 2. Permanent Library (NAS)
      - ${NAS_ROOT}:/data/library
      # 3. Heavy Data Overlays (NAS)
      # These "tunnel" into the main /data folder but save to the NAS
      - ${IMMICH_DATA_DIR}/thumbs:/data/thumbs
      - ${IMMICH_DATA_DIR}/video:/data/encoded-video
      - ${IMMICH_DATA_DIR}/profile:/data/profile
      - /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}
    command: ["/opt/venv/bin/python", "-m", "uvicorn", "immich_ml.main:app", "--host", "0.0.0.0", "--port", "3003"]
    environment:
      - MPLCONFIGDIR=/tmp/matplotlib
    # 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
    restart: always
    healthcheck:
      disable: false

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:9@sha256:3b55fbaa0cd93cf0d9d961f405e4dfcc70efe325e2d84da207a0a8e6d8fde4f9
    healthcheck:
      test: redis-cli ping || 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:

Immich Environment Variables Configuration
#

You can find documentation for all the supported environment variables in the official Immich documentation.

My .env Configuration
#

# You can find documentation for all the supported env variables at https://docs.immich.app/install/environment-variables

# SSD: Small system files and config
UPLOAD_LOCATION=/home/server1/immich-app/config

# NAS: Heavy system data (Thumbs/Video/Profile)
IMMICH_DATA_DIR=/mnt/main_nas/pictures/immich_data

# NAS: Permanent Photo Archive
NAS_ROOT=/mnt/main_nas/pictures

# SSD: Database (Must be on SSD)
DB_DATA_LOCATION=/home/server1/immich-app/config/postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
TZ=Europe/London

# The Immich version to use. You can pin this to a specific version like "v2.1.0"
IMMICH_VERSION=v2

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD= change

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# Custom User and Group IDs for file permissions
IMMICH_UID=1000
IMMICH_GID=1000

Default Database Credentials
#

The following credentials do not need to be changed unless you want to customize the setup:

DB_USERNAME: postgres
DB_DATABASE_NAME: immich

Documentation Links
#

Immich Environment Variables Documentation

This configuration ensures your Immich instance has the correct settings for file storage, database credentials, timezone, and version control.

My Immich Setup#

My Docker Compose Configuration#

Immich Environment Variables Configuration#

My .env Configuration#

Default Database Credentials#

Documentation Links#