Skip to content
My Own Suite

Immich

Immich is the photo and video layer for My Own Suite. It helps you back up media from your devices and keep your personal library under your control.

Core capabilities:

  • Back up photos and videos from your devices.
  • Organize media into a searchable private library.
  • Share albums with selected people.

Technical specs

Service: immich (server)

Note:

  • This stack uses Valkey for caching.
  • Immich upstream requires REDIS_* environment variable names, so those names remain unchanged.

Environment variables:

  • TZ
  • DB_HOSTNAME
  • DB_PORT
  • DB_USERNAME
  • DB_PASSWORD
  • DB_DATABASE_NAME
  • REDIS_HOSTNAME (Valkey/Redis-compatible endpoint)
  • REDIS_PORT
  • REDIS_PASSWORD (required when Valkey auth is enabled)
  • IMMICH_MACHINE_LEARNING_URL
  • UPLOAD_LOCATION

Volumes:

  • Required: /usr/src/app/upload

Start command:

  • Use the image default command (no override required).

Resource baseline:

  • Recommended minimum: 1 GB RAM, 1 vCPU
  • Preferred for smoother operation: 2 GB RAM

Service: immich-machine-learning

Environment variables:

  • TZ

Volumes:

  • Recommended: /cache

Start command:

  • Use the image default command (no override required).

Resource baseline:

  • Recommended minimum: 1 GB RAM, 1 vCPU
  • Preferred when processing large libraries: 2 GB RAM

Service: immich-postgres

Environment variables:

  • POSTGRES_USER
  • POSTGRES_PASSWORD
  • POSTGRES_DB
  • POSTGRES_INITDB_ARGS (recommended: --data-checksums)
  • PGDATA (recommended on mounted volumes: /var/lib/postgresql/data/pgdata)

Volumes:

  • Required: /var/lib/postgresql/data

Start command:

Terminal window
/usr/local/bin/immich-docker-entrypoint.sh postgres -c config_file=/etc/postgresql/postgresql.conf -c shared_preload_libraries=vchord.so,vectors.so

Resource baseline:

  • Recommended minimum for stable bootstrap: 2 GB RAM, 1 vCPU
  • Preferred for smoother first-run import/indexing: 4 GB RAM

Service: immich-valkey

Environment variables:

  • REDIS_PASSWORD (required only if Valkey auth is enabled; Immich expects this REDIS_* name)

Volumes:

  • None required.

Start command:

  • Use the image default command (no override required).
  • If Valkey auth is enabled, override start command:
Terminal window
valkey-server --requirepass "$REDIS_PASSWORD"

Resource baseline:

  • Recommended minimum: 256 MB RAM, 0.5 vCPU

Required service wiring

  • immich -> immich-postgres: DB_HOSTNAME, DB_PORT, DB_USERNAME, DB_PASSWORD, DB_DATABASE_NAME
  • immich -> immich-valkey: REDIS_HOSTNAME, REDIS_PORT, REDIS_PASSWORD (when Valkey auth is enabled)
  • immich -> immich-machine-learning: IMMICH_MACHINE_LEARNING_URL