Software-update: Immich 1.136.0

Immich screenshotImmich is een opensource oplossing voor het opslaan en beheren van foto's en video's. Het draait in Docker, waardoor je alles in eigen hand hebt en niet afhankelijk bent van een derde partij. Het wordt door velen als een serieuze concurrent van bijvoorbeeld Google Photos beschouwd. De media kan via een webbrowser worden benaderd en er zijn ook apps voor Android en iOS. Een demo van Immich is hier te vinden. Versie 1.136.0 is uitgekomen en daar zijn enkele grote veranderingen in aangebracht die mogelijk consequenties hebben, dus lees de releasenotes eerst door voor je bijwerkt.

BREAKING CHANGES

IMMICH_MEDIA_LOCATION (#19995)

Note: if you DO NOT have IMMICH_MEDIA_LOCATION in your .env file, or if it is set to a path that starts with a / (absolute path), THIS BREAKING CHANGE DOES NOT APPLY TO YOU. Users of the all-in-one image (e.g., the unraid app) for instance are not affected.

If you have a custom IMMICH_MEDIA_LOCATION environment variable set to a relative path, you will have to do the following process:

  1. Stop Immich (docker compose stop):
  2. Update Immich (docker compose pull)
  3. Update the environment variable to an absolute path, for example:
-IMMICH_MEDIA_LOCATION=./my-library
+IMMICH_MEDIA_LOCATION=/usr/src/app/my-library
  1. Start Immich (docker compose up -d --force-recreate)
  2. After the server successfully starts up, connect to it (docker exec ``*-it*`` immich_server /bin/sh) and run immich-admin change-media-location. When prompted, enter the appropriate values. For example:
docker exec -it immich_server /bin/sh

$ immich-admin change-media-location
...
? Enter the previous value of IMMICH_MEDIA_LOCATION: ./my-library
? Enter the new value of IMMICH_MEDIA_LOCATION: /usr/src/app/my-library

  Previous value: ./my-library
  Current value:  /usr/src/app/my-library

  Changing database paths from "my-library/*" to "/usr/src/app/my-library/*"

? Do you want to proceed? [Y/n] y

Matching database file paths were updated successfully! 

You may now set IMMICH_MEDIA_LOCATION=/usr/src/app/my-library and restart!
Background/Motivation

Relative paths have implied ambiguity, as they depend on the current working directory to resolve correctly, leading to issues like (#4465). This change removes this ambiguity and sets up the project to transition away from files living at /usr/src/app/upload entirely. Currently, the upload folder lives at /usr/src/app/upload/upload, which is very confusing… for everyone. This change opens to door for a future migration to something like IMMICH_DATA=/data, which a more sensible setup.

API Key changes (#20113)

Note: This change may affect the use of third-party applications, such as ImmichGo, ImmichKios, or ImmichFrame. This release includes a change to how API Keys work, specifically when used with routes that don’t require a specific permission. Previously, a scoped API Key could access these routes, but they will now throw a forbidden error. Routes without a declared scope now implicitly require the “all” permission.

Highlights

Welcome to release v1.136.0. This midsummer release is the culmination of the team's labor of love for the Immich community, featuring the introduction of a new timeline and sync mechanism in beta mode, Android widgets, and one of the last breaking changes we want to make before reaching the stable release milestone. Let’s dive right into it.

  • Beta mode for the new timeline, sync, and upload mechanism
  • Android widgets
  • iOS widget improvements
  • Deep links
Beta timeline, sync, and upload mechanism

This is only supported when both the server and the mobile app are updated to v1.136.0

This is a series of work that has been happening for months under the hood, from the changes in the database query engine, server’s queries, and support logic, to integrating a whole new database on the mobile app, and rewriting almost all aspects of the mobile app, you can now try the new timeline with data sync mechanism, and upload rework by go to the App Settings > Toggle the Beta timeline button. After toggling, you will be directed to a screen where data migration is executed automatically. You can then proceed to the new experience. You can distinguish the beta timeline from the old one by the beta symbol next to the Immich logo in the app bar.

Why?

Over the past year, the major complaints we've received from users have primarily centered around the mobile app. The app simply doesn't feel premium or responsive—it's often janky and takes too long to become usable when first opened, especially when you have a large number of albums. Users can't even view their local albums unless they've selected them as backup targets. Our technical debt in the data structure has created some truly frustrating behaviors, like forcing users to re-upload everything (only to have it rejected by the server) when they switch phones and end up with a different device ID. Or local photos and videos don’t show up until they are all hashed, which could take a while.

We've realized we can't honestly call the application stable or confidently recommend it to everyone until we resolve these fundamental problems. We genuinely want this app to be excellent. We want the user experience to be seamless and delightful—we want you to feel genuinely happy when you open Immich to browse through your precious memories.

What’s new? Data sync
  • The data sync is now running in a background thread, separate from the UI thread. This means that during data synchronization, the app will remain smooth to browse.
  • The data sync speed should be improved drastically. The data is being streamed to the mobile app instead of being sent there in a single large chunk. This will help users with a massive library.
  • The calculation of which data needs to be retrieved from the server is now performed on the server, rather than being calculated by the mobile app previously. This means lower CPU usage on the mobile app and quicker incremental sync.
  • The mobile app will now retrieve data from the server and maintain similar database tables within the app. This restructuring enables better offline operation and supports more complex usage behaviors.
Timeline/Display experience
  • The new timeline has been rewritten from the ground up to enhance scrolling and dragging behavior, making it easier for you to navigate the timeline.
  • The detail viewer is now more interactive, allowing you to scroll between photos or videos when the bottom detail sheet is opened.
  • The album views and other collection views are more lively, featuring a parallax effect to make your album/collection feel alive with mesmerizing animation.
  • You can now view all albums on the device, regardless of which album you have selected as the target for backing up. You can view them in the `Library > On this device` section. For users who want to select individual assets to back up to the server, they can perform that operation from here.
Upload
  • The upload mechanism has been rewritten from the ground up.
  • Upload is now handled by the OS, allowing for a better background upload operation. Instead of handling the uploading ourselves, we are now placing the photos and videos in a queue, which will run continuously when the Immich app is opened in the foreground and for a few minutes after it is put into the background. Then the OS will take over and start pulling tasks from the queue, handling the upload process by itself.
  • Starting the upload progress is now invoked from a toggle button
  • Uploads are now running in parallel . The new upload detail page displays which assets are being uploaded and whether they are experiencing issues or stuck. You can tap on each item to see exactly which asset is causing the problem.
  • On Android, there is no longer a virtual Recents album that includes all assets. Instead, there is a button to select all albums for backup.
  • In the backup album selection screen, you can now search for the album you want to back up.
Expectations of the beta version of the mentioned mechanisms
  • The app should be very smooth to browse around during the initial login and subsequent app openings.
  • Collections (favorite, archived, locked folder, etc.) and album views should make you feel nice, cozy, and delighted.
  • Background queuing of newly taken photos is not yet implemented. We will start working on this next.
  • Some views are not yet ported over to the new implementation, such as, but not limited to
    • People view
    • Map view
  • Some mechanisms are still missing from the previous implementation, such as, but not limited to
    • Add to album from multi-selection
    • Album sync when uploading
  • There are still some buggy behaviors/animations we will be ironing out in the coming days.
How can you help us?
  • Use the beta timeline and the new upload rework.
  • Report any bugs and weirdness you experience on GitHub’s issue tracker [beta] <your-title-here> as the title
  • Reach out and provide direct feedback on Discord
  • Feedback from iCloud users is greatly appreciated
Android Widgets

This is a follow-up to one of our most requested features: Home screen widgets! In v1.135.0 We introduced Immich widgets on iOS, which included a memory widget and a random widget. With v1.136.0, we bring these widgets to Android! Many of the improvements to iOS widgets listed below have also been incorporated into the Android version.

iOS Widget Improvements

iOS widgets have been improved with feedback from the community:

  • iOS widgets now support servers that use insecure HTTP connections
  • iOS widgets now support servers that use WebP as their preview thumbnail format
  • Tapping on the widget now takes you directly to the image in the app
  • Widgets now render properly when used on a tinted home screen
  • iOS widgets now cache the latest image for use if network access is unavailable during update. You should see fewer “Unable to connect to your Immich instance” errors on your home screen!
  • You can now choose to show images from your Favorites in the Random Widget
  • Improved error descriptions
Deep Links

You can now deep link into the Immich app. Supported URLs include:

  • immich://asset?id=<asset id>
  • immich://album?id=<album id>
  • immich://memory?id=<memory id>

Some my.immich.app URLs will also now open inside the mobile app:

  • https://my.immich.app/photos/<asset id>
  • https://my.immich.app/albums/<album id>

Navigating to any of these URLs (via the browser, Apple Shortcuts, NFC, or other automation frameworks) will open the corresponding resource inside the mobile app.

Immich

Versienummer 1.136.0
Releasestatus Final
Besturingssystemen Android, Linux, iOS
Website Immich
Download https://github.com/immich-app/immich/releases/tag/v1.136.0
Licentietype GPL

Door Bart van Klaveren

Downloads en Best Buy Guide

25-07-2025 • 11:30

17

Bron: Immich

Update-historie

Reacties (16)

16
16
7
0
0
9
Wijzig sortering
Bijzonder waardig hoe mooi deze software is. Heb een tijd lopen twijfelen omdat er nog geen stable build is. Maar ervaar 0 problemen. Zeker aanrader voor de mensen die zich bezighouden met selfhosting. Dit maakt mij wat minder afhankelijk van de diensten zoals apple/google. Sinds de introductie van de widget zie ik mijn gemaakt foto's regelmatig terug.


p.s. heb de nieuwe upload functie nog niet gebruikt. Ook ervaarde ik geen traagheidsproblemen binnen de app (ook niet bij eerdere versies). Dat laatst kwam voornamelijk omdat ik mijn foto's na een jaar uit de fotostream van mij iphone verwijder.

[Reactie gewijzigd door grote_oever op 25 juli 2025 12:15]

Inmiddels draai ik het al bijna 2 jaar op een Docker container, en ik heb tot nu toe absoluut NUL problemen gehad. Sure, tijdens de eerdere ontwikkelingstages, waren er héél veel veranderingen en moest je de Docker Compose file zo'n beetje elke maand wel aanpassen, maar zelfs dan waren er geen issues.

Ik ben zéér tevreden met Immich.
Ik twijfelde ook lang omdat het niet een stable build is. Aangezien je de bestanden gewoon kan benaderen op je server/nas, vond ik het risico acceptabel en om heel eerlijk te zijn werkt het tot nu toe perfect.
Kan ik deze tool over een bestaande map met foto's gebruiken of gaat ie ze dan ergens opnieuw importeren?

Ik zie deze tool redelijk vaak langs komen, reviews zijn erg positief.
Ik weet dat ze "External Libraries" ondersteunen: https://immich.app/docs/features/libraries

Dan wordt de hele map gescand en worden foto's ingeladen, maar dan blijft de hele mappenstructuur onaangetast. Alles wat Immich aan structurering doet wordt dan in de database opgeslagen. Het enige is dat als je dingen aanpast in de mappenstructuur dan moet Immich de boel opnieuw scannen. En vooralsnog worden verplaatste bestanden dan als "nieuw" gezien en moet je die dus weer opnieuw aan albums toevoegen.

Evt. kan je de map ook nog read-only maken, dan kan Immich niks verwijderen.
Weet dat external library nog vere van perfect is.

Ja het werkt zoals beschreven, je mappen blijven staan.

Maar een library is gekoppeld aan een user. Dus je moet hem per user toevoegen. En dan loopt de facial recognition ook per user, en niet gedeeld.

Hopelijk fixen ze dat snel.
Oef, lijkt een mooie update te zijn wat betreft de Android app, veel aanpassingen om deze toch meer responsive en soepel te houden. Dit waren juist veel van de negatieve reveiws op de Play Store.
Ben benieuwd hoe dit in de praktijk gaat uitpakken, misschien dat er gebruikers zijn die dit kunnen vaststellen ?
Eerste reactie is erg goed. Net de upgrade gedaan en het werkt erg soepel
Ik gebruik Immich al geruime tijd en ben er zeer tevreden mee! (wat mij betreft samen met Home Assistant een van de absolute toppers voor self hosted applicaties)

Deze laatste update maakt de app aanzienlijk prettiger in gebruik (als je de beta timeline inschakelt). Dit lost een voor mij grote ergernis op, n.l. de traagheid van de app nadat je die opstart (de app synct dan met de server, wat even kan duren en deze traagheid veroorzaakt). Nu de map / kaart in de app nog (die is helaas onbruikbaar als je veel foto's in Immich hebt staan) en ik ben happy :)
Ik vond het Immich acceptabel, muv gezichtsherkenning en de snelheid van de app. Maar mss moet ik het weer eens een kansje geven.
Mooi stukje software, maar haalt wat mij betreft nog niet bij Photoprism. De foto app van Synology is voor mij altijd nog de nummer 1. Deze foto app indexeert gewoon de mappen van je foto bibliotheek en houdt die structuur ook aan voor de albums.

Photoprism doet dat ook gewoon. Dat is voor mij echt een must. Ik wil mijn eigen structuur houden. Locatie/Jaar/Afbeeldingen.

Immich kan dan wel een externe lirary inladen, maar doet vervolgens helemaal niets met mappen structuur. Het maakt er weer een eigen lijst van waar ik niet op zit te wachten. Zo verschrikkelijk jammer. En om nou weer handmatig alle albums toe te gaan voegen en afbeelding te selecteren is me gewoon te veel werk met duizenden foto's.

Er is vaker naar een oplossing gevraagd waarbij de mappenstructuur als album aangemaakt wordt, maar daar is tot op heden jammer genoeg nog altijd niets mee gedaan. Ik hoop echt dat ze die snap nog wel een keer gaan zetten. Ik wacht met smart op deze optie.
je kan onder account settings > account > een storage label aanmaken, en dan gaat ie alle fotos in mapjes opslaan conform het album, het enige is dat wanneer je bijvoorbeeld een jaar grens over gaat dat je dan 2 mapjes hebt.

de structuur pas je aan onder administration > Storage template
Dank voor de uitleg. Ik ga eens even kijken of ik daar iets mee kan. :-)
Ik moet deze echt een keertje gaan proberen... zoek al een tijdje naar een goede management platform voor me foto's dat vooral selfhosted is.
Ik kan hem niet lekker aan de gang krijgen op mijn QNAP Nas helaas. Veel gedoe. Binnenkort maar eens weer proberen
Ik draai hem binnen Proxmox, maar deze update loopt stuk. Helaas maar teruggedraaid

Vandaag opnieuw geprobeerd, nu werkt het wel.

Op dit item kan niet meer gereageerd worden.