All Versions
24
Latest Version
Avg Release Cycle
10 days
Latest Release
1 day ago

Changelog History
Page 1

  • v3.0.0-rc.1 Changes

    June 17, 2026

    🚀 v3.0.0-rc.1 — Release Candidate

    ⚠ Warning

    Disclaimer

    🚀 This is a release candidate , not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.

    🚀 This second release candidate v3.0.0-rc.1 fixes bugs and issues that were found in the last release candidate. You can now use the release candidate tag v3-rc for all the prereleases under v3.

    🚀 Release notes

    🚀 Work-in-progress release notes can be found here:

    🚀 https://pr-558.dev.immich.app/blog/v3.0.0-release

    Server

    ⚡️ To use this RC version on the server, update the IMMICH_VERSION in your .env file:

    IMMICH_VERSION=v3.0.0-rc.1

    or

    IMMICH_VERSION=v3-rc

    Then pull and restart:

    docker compose pull&&docker compose up -d

    Mobile

    To use this RC version on the mobile app, follow the appropriate link for your platform:

    Android

    🚀 You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page

    image

    iOS

    ✅ Use the TestFlight link or scan the QR Code https://testflight.apple.com/join/JTSTucBd

    image

    🚀 If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

    What's Changed

    🌟 Enhancements

    🛠 🐛 Bug fixes

    📚 📚 Documentation

    • 📄 docs(server): clarify AssetBulkUploadCheckItem.id is a correlation token by @timonrieger in #29141

    🌐 🌐 Translations

    🆕 New Contributors

    Full Changelog : v3.0.0-rc.0...v3.0.0-rc.1

  • v3.0.0-rc.0 Changes

    June 15, 2026

    🚀 Immich v3.0.0-rc.0 — Release Candidate

    ⚠ Warning

    Disclaimer

    🚀 This is a release candidate , not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.

    🚀 We're excited to share our first release candidate (RC) for Immich v3: v3.0.0-rc.0. For information about how to use and test the RC, see below.

    🚀 Release notes

    🚀 Work in progress release notes can be found here:

    🚀 https://pr-558.dev.immich.app/blog/v3.0.0-release

    Server

    ⚡️ To use this RC version on the server update the IMMICH_VERSION in your .env file:

    - IMMICH\_VERSION=v2+ IMMICH\_VERSION=v3.0.0-rc.0

    Then pull and restart:

    docker compose pull&&docker compose up -d

    Mobile

    To use this RC version on the mobile app, follow the appropriate link for your platform:

    Android

    🚀 You can download the APK the in release note below, or tap on "Join the beta" from the Google Play Immich page

    image

    iOS

    ✅ Use the TestFlight link or scan the QR Code https://testflight.apple.com/join/JTSTucBd

    image

    🚀 If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

    What's Changed

    🚨 Breaking Changes

    🗄 🫥 Deprecated Changes

    🔒 🔒 Security

    • 🛠 fix: run profile picture through thumbnail pipeline by @bo0tzz in #27890

    🚀 Features

    🌟 Enhancements

  • v2.7.5 Changes

    April 13, 2026

    v2.7.5

    What's Changed

    🛠 🐛 Bug fixes

    • 🛠 fix(server): add rate limit and deduplication to version check by @zackpollard in #27747

    🌐 🌐 Translations

    Full Changelog : v2.7.4...v2.7.5

  • v2.7.4 Changes

    April 10, 2026

    v2.7.4

    🚀 This release addresses some issues with image rendering on the mobile app

    What's Changed

    🛠 🐛 Bug fixes

    Full Changelog : v2.7.3...v2.7.4

  • v2.7.3 Changes

    April 09, 2026

    v2.7.3

    What's Changed

    🛠 🐛 Bug fixes

    • 🛠 fix(server): avoid false restore failures on large database imports by @ErasmusAndre in #27420
    • 🛠 fix(mobile): improve image load cancellation handling by @LeLunZ in #27624
    • 🛠 fix(server): people search not showing for 3 or less characters by @zackpollard in #27629
    • 🛠 fix(web): don't cache empty search results for people search by @zackpollard in #27632
    • 🛠 fix(mobile): get provider refs before async gaps in backup page by @LeLunZ in #27597
    • 🛠 fix: ssr open graph tags by @jrasm91 in #27639

    📚 📚 Documentation

    🆕 New Contributors

    Full Changelog : v2.7.2...v2.7.3

  • v2.7.2 Changes

    April 07, 2026

    You knew it was coming 😅

    🚀 This release addresses the following issues:

    • 🛠 Fix an issue with the default helmet.json file
    • 🛠 Fix an issue with ML containers not working on some older CPUs
    • 🛠 Fix an issue with importing external libraries

    What's Changed

    🛠 🐛 Bug fixes

    Full Changelog : v2.7.0...v2.7.2

  • v2.7.0 Changes

    April 07, 2026

    v2.7.0

    Welcome to Immich v2.7.0!

    🚀 This release includes enhancements to the asset viewer, security improvements, changes to the duplicate APIs and viewer, and a bunch of bug fixes. Keep reading below for the complete highlights and a note on the upcoming v3.0.0 release.

    Note

    We're working on a managed backup service for Immich with end-to-end encrypted backups of your library to a remote datacentre where only you hold the keys.

    👍 We've put together a quick survey (~5 mins) to get a better idea of how you're backing things up today and what you'd actually want from something like this. Your answers help us figure out what to prioritise, so we'd really appreciate it if you took a few minutes to fill it out.

    🆓 Leave your email at the end if you're interested in joining our free closed beta when it's ready.

    https://futo-backups-survey.immich.app/

    Known limitations

    • 🚀 The machine learning service on amd64 currently requires the >= x86-64-v2 microarchitecture. This will be patched in an upcoming patch release for backward compatibility with very old processors (before ~2010), but it will become a minimum requirement in 3.0. arm64 is not affected by this change.

    Highlights

    • ✂ Remove from album (asset viewer)
    • 🚚 Move to locked folder (folder page)
    • Editor shortcuts
    • Create a new face on-the-fly in the face tag editor
    • Resolve duplicates
    • 🔧 Helmet configuration
    • 🔖 Version check infrastructure
    • Notable fix: live photo and video download in Safari
    • Notable fix: escape HTML in the Panorama Photo Viewer

    ✂ Remove from album

    🚚 The web has a new action, "Remove from album," available in the asset viewer that makes it easier to remove an asset from an album. This action is available to both album and asset owners.

    image

    🚚 Move to locked folder in the Folder view

    🚚 Similarly, the folder view now includes the "Move to locked folder" action.

    image

    Editor shortcuts

    🌐 Users on the web can now edit with keyboard shortcuts. Press e to open the editor. Once in the editor, press [ or ] to rotate the asset +/- 90 degrees. Finally, save any changes and close the editor with ENTER.

    💅 slice.mp4

    Create a new face on-the-fly in the face tag editor

    You can now create a new face/person on the fly from the face tagging editor interface

    imageimage

    Deduplication improvements

    📚 The duplicate screen has gone through a bunch of iterations since it was first introduced all the way back in May, 2024. The latest release moves a bunch of logic from the client to the server, which now automatically suggests which asset to keep based on image size and EXIF data. Additionally, the new server implementation will automatically synchronize metadata, including albums, favorite status, rating, description, visibility, location, and tags. For more information about this process, see the new documentation.

    🔧 Helmet configuration

    You can now opt in to using a Content Security Policy (CSP) in Immich. The new environment variant IMMICH_HELMET_FILE accepts a boolean or a path to a helmet configuration file.

    Recommend action: The team recommends setting IMMICH_HELMET_FILE=true to enable the default policy. Then, please let us know if you run into any issues with it.

    Background and details

    Since Immich is deployed in so many different ways, it has been hard to figure out how to enable a CSP that would not conflict with or break existing installs that might use 3rd party map providers, custom CSS, embed Immich in an iframe, or other such features. In this release, we have added the ability to both opt in to a default policy and configure a custom one. To use the default policy, simply set the environment variable IMMICH_HELMET_FILE=true. To use a custom policy, set the environment variable to a path on disk (within the immich-server) that contains a valid helmet configuration (e.g. IMMICH_HELMET_FILE=/opt/immich/helmet.json). CSP can be used to control what scripts are allowed to run on the page, which domains to load images from, etc. Additionally, it can be used to configure headers for Referrer-Policy, X-Powered-By, X-Frame-Options, and others.

    🆕 New version check infrastructure

    🚀 Prior to this release, instances that used the automatic version check feature would send HTTP requests to github.com. Now, we have set up a small service at version.immich.cloud to handle these types of requests. This avoids any privacy implications of connecting to github.com , as well as moves the request load to our own infrastructure.

    Notable fix: live photo and video download in Safari

    🚀 When downloading files in Safari with the same name, it will simply overwrite the file instead of automatically renaming it. In this release, the still and motion parts of a live photo are now named differently to prevent this from happening.

    Notable fix: escape HTML in panorama photo viewer

    🚀 In v2.6.0, we added the ability to show/view clip text in the panorama viewer, but introduced an XSS vulnerability, which has been fixed in this release. Interestingly, this was XSS using text in the image, which would then get read by OCR.

    Notable fix: Immich User Agent for external requests

    🌐 Similar to the mobile app, the server now sends a custom User Agent header. The format for the User Agent is immich-server/{version}. For example, immich-server/2.7.0.

    v3.0.0

    Just a heads up that this is the likely to be the last release before v3.0.0. Being a major release there will be a handful of breaking changes, although it's worth noting that nothing is currently planned that requires user intervention. It is mainly changes that impact 3rd party developers. More information and details should be available in the coming weeks.

    👌 Support Immich

    👍

    👍 If you find the project helpful, you can support Immich by purchasing a product key at https://buy.immich.app or our merchandise at https://immich.store

    What's Changed

    🚀 Features

    🌟 Enhancements

    🛠 🐛 Bug fixes

  • v2.6.3 Changes

    March 26, 2026

    v2.6.3

    What's Changed

    🛠 🐛 Bug fixes

    Full Changelog : v2.6.2...v2.6.3

  • v2.6.2 Changes

    March 24, 2026

    v2.6.2

    🚀 This release addresses the following issues

    • 🛠 Fixed a bug where the shared link would error out when public users upload to the shared link
    • 🛠 Fixed a bug where the URL switching feature doesn't work with external URLs
    • 🛠 Fixed a bug where the "add to album" selection box on the web doesn't include albums that are shared with the user
    • 🛠 Fixed several issues regarding the search filter on the mobile app and the web

    What's Changed

    🛠 🐛 Bug fixes

    📚 📚 Documentation

    🆕 New Contributors

    Full Changelog : v2.6.1...v2.6.2

  • v2.6.1 Changes

    March 19, 2026

    v2.6.1

    🛠 Hot fixes

    • 🛠 Fixed a failed migration issue on the mobile app when the URL Switching feature is used

    What's Changed

    🛠 🐛 Bug fixes

    Full Changelog : v2.6.0...v2.6.1