Introducing a new way to review your PRs.

Read the announcement

immich-app / immich

High performance self-hosted photo and video management solution.

View on GitHub

21 documents · Updated Oct 19, 2026

overview

Knowledge Base updated: 2026-10-18

Immich knowledge base

Orientation

Immich is a self-hosted photo and video platform with a NestJS server, Svelte web client, Flutter mobile client, Python machine-learning service, and Rust-backed native mobile media utilities.

Critical durable state lives in PostgreSQL through the server repository and migration layers, while original media and derived files are managed through configurable storage abstractions. Client applications reconcile library, session, and activity state through server APIs and realtime connections.

The server coordinates HTTP APIs, background jobs, media processing, search and analysis, and external contracts. Deployment configuration composes these services for production and end-to-end validation.

flowchart TD
  Web[Svelte web application] --> API[NestJS API server]
  Mobile[Flutter mobile application] --> API
  CLI[CLI, SDKs, plugins] --> API
  API --> DB[(PostgreSQL)]
  API --> Storage[Storage abstraction]
  API --> Queue[Job queues and workers]
  Queue --> Media[Media processing]
  Queue --> Analysis[Automated asset analysis]
  Analysis --> ML[Python machine-learning service]
  API --> Realtime[WebSocket and activity state]
  Mobile --> Native[Rust native media core]
  Deploy[Container deployment] --> API
  Deploy --> ML
  Deploy --> DB

Glossary

  • Asset — a photo, video, or related media record with persisted metadata and stored files.
  • Library — a configured source of user media and its associated synchronization state.
  • Storage template — a configurable naming and layout rule for media stored by the server.
  • Smart information — machine-derived asset data used for discovery, including visual and text analysis outputs.
  • ThumbHash — a compact image placeholder representation produced by native mobile media utilities.

Invariants

Routing table