v1.137.0

• knock, knock
• Who's there?
• Breaking
• Breaking who?
• Breaking changes woohoo, with a stable-release-is-around-the-corner and coming to a server near you (soon™)

[!CAUTION]

Breaking Changes

If your current, running version of Immich is v1.132.0 or newer, there is NO ACTION required. If you are updating from version below v1.132.0 continue reading.

Remove TypeORM (#20366)

This update requires applications to have started up at least once on 1.132.0+. See https://immich.app/errors/#typeorm-upgrade for more details.

Highlights

Welcome to the release v1.137.0 of Immich. This version adds many bug fixes for the beta timeline, more feature parity with the old timeline, alongside some nifty enhancements to the web and the server as well. As always, new translations have been merged in, and the documentation has been updated at https://immich.app. Now, let’s dive in!

• The default docker-compose.yml template has changed
• Beta timeline
• Shared link custom URL
• Find large files utility
• API key permission improvements

docker-compose.yml template change (optional)

The default compose file now uses /data instead of /usr/src/app/upload. This is a completely optional change and NOT a breaking change. Prior versions of Immich will continue to work without any user intervention. For more information, see [#20367].

Prior to this change, uploaded media was located at /usr/src/app/upload/upload in the container (notice the double “upload” folders), which often led to confusion. It will now be located at /data/upload, and we hope that makes things easier.

Beta timeline

Thank you to everyone who tried out the beta timeline in the last release! We have gathered a lot of great feedback, and are actively working on incorporating it. We’ve fixed a bunch of bugs and added back a bunch of previous features. Here’s a quick list/overview of beta timeline changes this release:

• Fix the invalid timeline grouping issue
• Fix the trash action translation keys
• Fix the beta timeline switch missing in landscape mode
• Fix a timeline migration bug on Android
• Fix the text overflow issue on the action buttons
• Fix deep links when the beta timeline is enabled
• Fix search places not working correctly
• Fix missing hero animation between tabs
• Fix the backup remainder backup count issue
• Fix the share to app upload
• Fix the error navigating back from the backup page
• Fix the backup indicator
• Fix the back gesture in multi-select mode
• Fix user profile images
• Fix the issue downloading live photo
• Fix the issue with sync for users with external libraries
• Fix the issue with storage filling up for users with iCloud photos

… and more

Shared link custom URL (#19999)

Immich shared links by default are long and hard to guess. This is by design and is a security mechanism to prevent unwanted access. However, the long links can be a bit awkward to use because they are difficult to read. For cases where security is less important, we have added the option to specify a custom URL.

Shared links with a custom URL are now also available at `/s/<slug>` (in addition to `/share/<long-random-string>`. Naturally, these links don’t share the same security benefits of the long-random-string ones, so please use them accordingly. ## Find large files utility (web-only) This release adds a new, convenient utility to find large files on your instance. You can access it by navigating to the “Utility” page on the web, and clicking “Review large files”. The page shows the largest 250 original files for your user.

## Improved API key permissions and documentation Following up from the last release, we have added fine-grained permissions to more API endpoints, which are now also included in the auto-generated documentation, which can be read [here](https://immich.app/docs/api). > \[!CAUTION\] > > Related to these changes, a few API permissions have been *renamed*. See [#20250] for more details. On the web, the New API Key form now includes the newly added permissions, as well as a search bar for quicker access.

## What's Changed ### 🚨 Breaking Changes * feat!: more permissions by @jrasm91 in <https://github.com/immich-app/immich/pull/20250> * feat!: remove typeorm by @jrasm91 in <https://github.com/immich-app/immich/pull/20366> ### 🚀 Features * feat: automatically detect media location changes by @jrasm91 in <https://github.com/immich-app/immich/pull/20256> * feat: find large files utility by @niwla23 in <https://github.com/immich-app/immich/pull/18040> * feat: change default media location to /data by @jrasm91 in <https://github.com/immich-app/immich/pull/20367> * feat: better endpoint descriptions by @jrasm91 in <https://github.com/immich-app/immich/pull/20439> ### 🌟 Enhancements * feat: don't wait for network on app startup by @zackpollard in <https://github.com/immich-app/immich/pull/20232> * feat: add to album on new beta timeline by @bwees in <https://github.com/immich-app/immich/pull/20119> * feat(web): api key permission search by @jrasm91 in <https://github.com/immich-app/immich/pull/20248> * chore: delete action button by @alextran1502 in <https://github.com/immich-app/immich/pull/20261> * feat: scroll to top & view in timeline by @alextran1502 in <https://github.com/immich-app/immich/pull/20274> * feat(web): auto fit bounds for map modal. by @dagstuan in <https://github.com/immich-app/immich/pull/20345> * feat: shared links custom URL by @Jed-Giblin in <https://github.com/immich-app/immich/pull/19999> * feat: support config via systemd credentials by @amarshall in <https://github.com/immich-app/immich/pull/20406> * feat: 3-2-1 backup onboarding card by @bwees in <https://github.com/immich-app/immich/pull/20374> * feat: people page/sheet/detail by @alextran1502 in <https://github.com/immich-app/immich/pull/20309> * fix(web): Search chip key value heights don't match by @xCJPECKOVERx in <https://github.com/immich-app/immich/pull/20312> * feat: network requirement option for upload by @alextran1502 in <https://github.com/immich-app/immich/pull/20302> * feat: drift edit time and date action by @bwees in <https://github.com/immich-app/immich/pull/20377> * feat: drift description editor by @bwees in <https://github.com/immich-app/immich/pull/20383> ### 🐛 Bug fixes * fix: override SSL options inside isolates by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20142> * fix: fallback auto grouping to day grouping by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20156> * fix: update trash action i18n keys by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20164> * chore: remove build flavor Android by @alextran1502 in <https://github.com/immich-app/immich/pull/20161> * fix: send correct includeArchived parameter to API when showing markers in map by @pelluch in <https://github.com/immich-app/immich/pull/20117> * fix(web): multi-select in ascending asset order by @wuzihao051119 in <https://github.com/immich-app/immich/pull/19461> * fix(mobile): hide video thumbnail when video is ready by @johnstef99 in <https://github.com/immich-app/immich/pull/19328> * fix: geodata_places pkey migration failing for certain upgrade paths by @zackpollard in <https://github.com/immich-app/immich/pull/20177> * fix: add beta toggle in landscape mode by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20187> * fix: add missing `await`s when changing client certificate by @jfly in <https://github.com/immich-app/immich/pull/20189> * fix: android backup album migration without recents by @zackpollard in <https://github.com/immich-app/immich/pull/20220> * fix: optional number inputs by @danieldietzler in <https://github.com/immich-app/immich/pull/20218> * fix: character width calculation by @alextran1502 in <https://github.com/immich-app/immich/pull/20201> * fix: word wrapping on action buttons by @bwees in <https://github.com/immich-app/immich/pull/20231> * fix: lookup the primary key constraint name before dropping it by @zackpollard in <https://github.com/immich-app/immich/pull/20221> * fix(mobile): deep links when using the beta timeline by @bwees in <https://github.com/immich-app/immich/pull/20111> * fix(mobile): beta search page improvements by @bwees in <https://github.com/immich-app/immich/pull/20247> * fix(mobile): places search not working in beta version by @YarosMallorca in <https://github.com/immich-app/immich/pull/20284> * fix: no hero animation after tab change by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20285> * fix: remainder backup count by @alextran1502 in <https://github.com/immich-app/immich/pull/20270> * fix: share to app upload by @alextran1502 in <https://github.com/immich-app/immich/pull/20271> * fix: error on navigating back from backup selection page by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20299> * fix(web): Album picker recent albums don't match sidebar by @xCJPECKOVERx in <https://github.com/immich-app/immich/pull/20313> * fix: change translation key for archive action button by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20336> * fix: backup indicator in beta app bar by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20354> * fix: handle back gesture in multi selection mode by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20356> * fix: handle cleanup of new backups alongside old backups by @zackpollard in <https://github.com/immich-app/immich/pull/20402> * fix: android widget periodic updates by @bwees in <https://github.com/immich-app/immich/pull/20389> * fix: show missing local assets only in timeline with partner sharing by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20298> * fix: sync is_favorite from native by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20412> * fix(web): timeline date group width by @ben-basten in <https://github.com/immich-app/immich/pull/19964> * fix: exclude assets from excluded albumbs on main timeline by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20425> * fix: user profile images not working in beta timeline by @bwees in <https://github.com/immich-app/immich/pull/20203> * fix(web): timeline time bucket issue by @jrasm91 in <https://github.com/immich-app/immich/pull/20438> * fix: json encoding failure during live photo download by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20444> * fix(mobile): add partial index based on library ID to remote assets by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20214> * fix: clear local file cache before upload by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20448> * fix(download): handle completed downloads and refresh albums by @PeterOmbodi in <https://github.com/immich-app/immich/pull/20241> * fix: incorrect next/previous action after folder view refresh by @jrasm91 in <https://github.com/immich-app/immich/pull/20447> * fix: modal race conditions by @danieldietzler in <https://github.com/immich-app/immich/pull/20460> ### 📚 Documentation * docs: more make commands and add mobile checks to pr-checklist by @shenlong-tanwen in <https://github.com/immich-app/immich/pull/20211> * chore: add missing 'make pigeon' instruction by @jfly in <https://github.com/immich-app/immich/pull/20202> * fix(docs): update SQL queries with schema changes by @mmomjian in <https://github.com/immich-app/immich/pull/20297> * feat(docs): reorganize DB queries, add tags by @mmomjian in <https://github.com/immich-app/immich/pull/20303> * docs: add immich_ml_balancer to community projects by @apetersson in <https://github.com/immich-app/immich/pull/20399> * docs: Add config example for Authelia by @Starbix in <https://github.com/immich-app/immich/pull/20223> ### 🌐 Translations * fix(mobile): distinguish backup settings title from 'backup_controller_page_backup' translation entry by @zigarn in <https://github.com/immich-app/immich/pull/20237> * fix(mobile): remove unused translation and pluralize existing one for map photos count by @zigarn in <https://github.com/immich-app/immich/pull/20282> * chore(web): update translations by @weblate in <https://github.com/immich-app/immich/pull/20105> ## New Contributors * @pelluch made their first contribution in <https://github.com/immich-app/immich/pull/20117> * @jfly made their first contribution in <https://github.com/immich-app/immich/pull/20189> * @zigarn made their first contribution in <https://github.com/immich-app/immich/pull/20237> * @beposec made their first contribution in <https://github.com/immich-app/immich/pull/20283> * @Jed-Giblin made their first contribution in <https://github.com/immich-app/immich/pull/19999> * @niwla23 made their first contribution in <https://github.com/immich-app/immich/pull/18040> * @apetersson made their first contribution in <https://github.com/immich-app/immich/pull/20399> * @amarshall made their first contribution in <https://github.com/immich-app/immich/pull/20406> * @Starbix made their first contribution in <https://github.com/immich-app/immich/pull/20223> * @PeterOmbodi made their first contribution in <https://github.com/immich-app/immich/pull/20241> **Full Changelog**: <https://github.com/immich-app/immich/compare/v1.136.0...v1.137.0>