Identity

Stack: multi-container Docker Compose application — 5 services minimum
- immich-server — API, web UI, upload handling (port 2283)
- immich-microservices — background job worker (thumbnail generation, metadata extraction, video transcoding)
- immich-machine-learning — face detection, CLIP semantic search (optional but common)
- database — PostgreSQL with pgvecto-rs extension (NOT standard postgres — the vector extension is required)
- redis — job queue broker between server and microservices
Config: .env file in the same directory as docker-compose.yml
Port: 2283/tcp (HTTP — reverse-proxy this; Immich has no built-in TLS)
Upload dir: controlled by UPLOAD_LOCATION in .env — must be a persistent volume mount
Project page: https://immich.app

Key Operations

Goal	Command
Check all container status	`docker compose ps`
View logs (all containers)	`docker compose logs -f`
View logs for specific service	`docker compose logs -f immich-server`