Immich announced version 3.0.0, the latest major release of its open‑source photo management platform. The update introduces several breaking API changes, new features such as non‑destructive mobile editing, workflow automation, and real‑time video transcoding, and requires users to adjust their configuration to migrate.

Immich began as a community‑driven tool for organizing digital media and has evolved through incremental releases, with version 2.5.0 adding web editing capabilities. The 3.0.0 release marks a significant overhaul of the API and underlying architecture.

Key changes include updating the IMMICH_VERSION variable in the .env file from v2 to v3 and running docker compose pull and up commands. Several endpoints have been removed or deprecated, including the /api/server/theme endpoint and deprecated environment variables. The project adopted Zod for validation, replaced class‑validator, and introduced structured error responses. New capabilities include mobile editing that mirrors the web editor, a workflow builder with visual and JSON interfaces, background backup that now processes the entire library, a recently added page sorted by upload time, integrity reports that verify file existence and checksums, slideshow support on mobile, HLS video streaming with optional real‑time transcoding, a custom web video player, Android integration that lets the app act as a system gallery, OCR text recognition in images, and direct upload to albums from the mobile interface.

Community members are encouraged to propose new triggers and actions through the project discussion thread, and support can be provided by purchasing a product key or merchandise.