spoke-immich

Spoke module for Immich self-hosted photo and video management.

Services

Service	Description	Port	Network
immich-server	Main application server	2283	troxy
immich-machine-learning	ML inference (face/object)	3003	troxy
immich-postgres	PostgreSQL 18 with vectorchord + pgvector	5432	troxy
immich-redis	Valkey cache & job queue	6379	troxy

Prerequisites

• Spoke hub deployed with troxy network
• Traefik available as a hub service
• GPU passthrough (/dev/dri) for hardware transcoding
• immich_db_password secret created

Quick Start

cp .env.example .env
# Edit .env — set data paths
docker compose up -d

Module Environment Variables

Variable	Default	Description
IMMICH_VERSION	v2.7.5	Immich version tag
IMMICH_SERVER_IMAGE	ghcr.io/immich-app/immich-server:v2.7.5	Server image
IMMICH_MACHINE_LEARNING_IMAGE	ghcr.io/immich-app/immich-machine-learning:v2.7.5	ML image
IMMICH_POSTGRES_VERSION	18-vectorchord0.5.3-pgvector0.8.1	Postgres version tag
IMMICH_POSTGRES_IMAGE	ghcr.io/immich-app/postgres:18-vectorchord0.5.3-pgvector0.8.1	Postgres image
IMMICH_REDIS_VERSION	9	Valkey version tag
IMMICH_REDIS_IMAGE	docker.io/valkey/valkey:9	Valkey/Redis image
IMMICH_SERVER_IP	192.168.35.28	Server static IP
IMMICH_ML_IP	192.168.35.29	ML static IP
IMMICH_POSTGRES_IP	192.168.35.30	Postgres static IP
IMMICH_REDIS_IP	192.168.35.31	Redis static IP
IMMICH_HOST	img.${DOMAIN}	Public hostname
IMMICH_DB_USER	immich	Database username
IMMICH_DB_NAME	immich	Database name
IMMICH_UPLOAD_DIR	${APPDATA_DIR}/immich/upload	Upload data path
IMMICH_LIBRARY_DIR	${APPDATA_DIR}/immich/library	Library data path

References

• Immich Documentation
• Immich GitHub