Skip to content

Releases: immich-app/immich

v1.120.0 - 50.000 Stars Release

06 Nov 16:47
@github-actions github-actions
v1.120.0
f1b8a93
Compare
Choose a tag to compare
v1.120.0 - 50.000 Stars Release

v1.120.0 - 50.000 Stars Release

Welcome to release v1.120.0 of Immich. We've reached 50.000 stars on GitHub. Thank you for your love, support, and contributions to the project.

This release introduces a new built-in automatic database dump feature as well as bug fixes and enhancements. Some of the highlights include:

  • Built-in automatic database backups
  • Timeline location indicator on scrolling
  • The web is now on Svelte 5
  • Faster CPU transcoding for HDR videos
  • Notable fix: Slow server start-up time on some systems

Built-in automatic database backups

This release introduces a mechanism that automatically creates a database dump and is enabled by default. It will run at 2 AM server time and keep the last 14 backups, all of which are configurable. You can find the settings in Administration > Settings > Backup Settings

image

The database zip files are placed at <UPLOAD_LOCATION>/backups.

Below is an example of a database backup size for a library with 80_000 assets.

image

Currently, restores must be done manually, and instructions can be found in the documentation

Timeline location indicator on scrolling

The timeline on the web will now show the Month/Year information while scrolling to better indicate the viewport context.

Screen.Recording.2024-11-06.at.08.46.53.mov

Faster CPU transcoding for HDR videos

Immich now uses a faster tone-mapping implementation developed by the Jellyfin team to map colors from HDR to SDR. During testing, overall transcoding speed improved by as much as 69% for a 4K target resolution. The exact improvement will depend on hardware, source video, and transcoding settings.

Note

Note for third-party Immich distributions: as this filter only exists in jellyfin-ffmpeg, please ensure you use this build instead of a standard FFmpeg build.

Support Immich

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

Cheers! 🍻

What's Changed

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.119.1...v1.120.0

Contributors

C-Otto, zackpollard, and 13 other contributors
Loading
31 Join discussion

v1.119.1

29 Oct 13:57
@github-actions github-actions
v1.119.1
00dd941
Compare
Choose a tag to compare
v1.119.1

v1.119.1

This patch release adds job options to the search view context menu when bulk-selecting assets.

image

What's Changed

🌟 Enhancements

📚 Documentation

  • docs: note about Nginx reverse proxy compatibility with Let's Encrypt by @yozik04 in #13764
  • docs: Add info about album sync&folder view by @aviv926 in #12371

New Contributors

Full Changelog: v1.119.0...v1.119.1

Contributors

yozik04, alextran1502, and aviv926
Loading

v1.119.0

28 Oct 15:55
@github-actions github-actions
v1.119.0
8449e78
Compare
Choose a tag to compare
v1.119.0

v1.119.0

Caution

The env variable for the host binding was erroneously named HOST instead of IMMICH_HOST (which is how it was listed in the docs). This has been corrected in this release.
If you were using the HOST env var in your setup before, please update it to IMMICH_HOST.

If you are using the built-in Prometheus endpoint for monitoring, please read on. If not, you can ignore this section.

The following env variables have been removed:

  • IMMICH_METRICS
  • IMMICH_API_METRICS
  • IMMICH_HOST_METRICS
  • IMMICH_IO_METRICS
  • IMMICH_JOB_METRICS

Use IMMICH_TELEMETRY_INCLUDE / IMMICH_TELEMETRY_EXCLUDE instead.

Examples:

-- IMMICH_METRICS=true
++ IMMICH_TELEMETRY_INCLUDE=all
-- IMMICH_METRICS=true
-- IMMICH_HOST_METRICS=false
++ IMMICH_TELEMETRY_INCLUDE=all
++ IMMICH_TELEMETRY_EXCLUDE=host
-- IMMICH_API_METRICS=true
-- IMMICH_HOST_METRICS=true
++ IMMICH_TELEMETRY_INCLUDE=api,host

Welcome to release v1.119.0 of Immich. This release focuses on fixing issues surrounding video encoding and thumbnail generation for a variety of old and new formats, along with minor improvements across the app. Some of the highlights below:

  • Create new OAuth users without passwords
  • Debounce email notifications for album changes
  • Improve mobile app layout on tablets
  • VAAPI hardware decoding
  • Notable fix: Face Detection using excessive RAM with OpenVINO
  • Notable fix: transcodes not playing in the mobile app in certain situations

VAAPI hardware decoding

Prior to this release, Immich only used VAAPI for video encoding; it still used the CPU for decoding and tone-mapping. This release adds end-to-end acceleration for VAAPI, making transcoding much faster with lower CPU utilization. With this addition, every supported acceleration API now has end-to-end acceleration in Immich.

If you use VAAPI hardware acceleration, you can enable hardware decoding in the transcoding settings to take advantage of this change.

Transcoding fix for mobile

When the source video is Dolby Vision, transcodes sometimes either didn't play in the mobile app, or only the audio was played. In particular, this meant that many videos captured on iOS could not be viewed on Android.

This issue has been fixed. However, existing transcodes of Dolby Vision videos created using Immich 1.114.0 - 1.118.2 will still have the issue and will need to be re-transcoded for correct playback in these cases.

To re-transcode affected videos, you can either select them in the web app and choose the Refresh encoded videos option or go to the Job Status page and click All next to Transcode Videos.

Note: you only need to do this if you encounter playback issues for these videos.

Support Immich

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

Cheers! 🍻

What's Changed

🚨 Breaking Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.118.2...v1.119.0

Contributors

etnoy, chriskoch, and 23 other contributors
Loading
14 Join discussion

v1.118.2

16 Oct 19:03
@github-actions github-actions
v1.118.2
e8015dc
Compare
Choose a tag to compare
v1.118.2

Warning

Version v1.118.0 contains breaking changes. Read about them here.

Hotfixes

This release fixes images from Whatsapp failing to be processed, as well as an issue with video thumbnail generation failing in some cases. It also includes the FFmpeg 6.0 -> 7.0 upgrade that was scheduled for the next release, but oh well 🙃

What's Changed

🐛 Bug fixes

New Contributors

Full Changelog: v1.118.1...v1.118.2

Contributors

lyynd and MananJain-IITJ
Loading

v1.118.1

15 Oct 20:57
@github-actions github-actions
v1.118.1
edd7dfb
Compare
Choose a tag to compare
v1.118.1

Warning

Version v1.118.0 contains breaking changes. Read about them here.

Hotfixes

This release fixes some bugs introduced in version v1.118.0, specifically an issue with Google OAuth and mobile.

What's Changed

🐛 Bug fixes

📚 Documentation

New Contributors

Full Changelog: v1.118.0...v1.118.1

Contributors

kevincox, jrasm91, and ngtrio
Loading

v1.118.0

15 Oct 11:04
@github-actions github-actions
v1.118.0
8f69d9d
Compare
Choose a tag to compare
v1.118.0

v1.118.0

Welcome to release v1.118.0 of Immich. This version comes with several breaking changes, and also improvements to the mobile app UI and UX, a new documentation home page, as well as bug fixes and enhancements across the app. We hope you enjoy this release!

Warning

Breaking changes

This release includes the following breaking changes:

  1. Port alignment
  2. Remove deprecated API endpoints
  3. Remove deprecated start.sh arguments

1. Port alignment

We aligned the internal port of the immich-server to be similar to the binding port. Please make the following change to your docker-compose.yml file under the immich-server section. Reverse proxies using port 3001 also need to be updated to use port 2283.

services:
  immich-server:
    container_name: immich_server
    ...
    ports:
-    - 2283:3001
+    - 2283:2283
    ...

2. Remove deprecated API endpoints

The following endpoints were previously deprecated and have been removed, if you are a community project maintainer and using one of the endpoints below, please make sure to make changes to your project:

  • /api/server-info/* has been removed. Use /api/server/* instead.
  • /api/people/:id/assets has been removed. Use /api/search/metadata instead.

Note

This includes /api/server-info/ping, /api/server-info/version, /api/server-features, /api/server-info/config, /api/server-info/statistics, and others.

3. Remove deprecated start.sh arguments

The following docker commands have been removed:

  • start.sh immich
  • start.sh microservices

Follow the steps below to align docker-compose.yml with the default setup.

Note

These steps are only required if you still have the immich-microservices section in your docker-compose.yml or didn't follow the previous instructions to remove the command section. If you don't have the mentioned content below, you can ignore this

1. Update docker-compose.yml

Remove the command line from immich-server and the entire immich-microservices service section as shown below.

services:
  immich-server:
    container_name: immich_server
    ...
    :
-   command: [ "start.sh", "immich" ]
    ...
    
-  immich-microservices:
-    container_name: immich_microservices
-    ...
-    :
-    command: [ "start.sh", "microservices" ]
-    ...

2. Remove the running immich-microservices container

Run docker compose down --remove-orphans after updating docker-compose.yml to remove the old immich-microservices container.

Highlights

Some of the highlights for this release include the following:

  • Mobile UI/UX improvement
  • Option to refresh face detection
  • Color filters for editing photos
  • Timezone improvements
  • Deprecated release notes section
  • Better JPEG compression
  • Multi-GPU support for ML

Mobile UI/UX improvement

Thank you all for the great feedback from the dicussion we made a month ago about the proposed changes to the mobile app layout. We hope the following changes will provide more fluid experience when browing and managing your photos and videos.

Navigation bar

Photos and albums are the two most used pages. To make them more accessible, we replaced the Sharing page with a new Albums page where you can find all of the album related features and functions.

image

Albums page

This new page allows users to quickly view, sort, search, filter, create, and manage albums.

image

Library page

The library page now includes quick access buttons to various views, including

  • Favorites
  • Archived
  • Shared links
  • Trash
  • People
  • Places
  • Device albums
  • Partner sharing

image image

Search page

Many of the items that were previously on this page have been moved to the Library page, mentioned above. As a result, the search page is less cluttered and includes quick access search chips and queries. Also, clicking on the search navbar item a second time will focus on the search bar and open the keyboard for easy access.

image

Color filters for editing photos

This release introduces colors filter option in the edit menu on the mobile app. You can apply a set of presets colors to your photo. Thanks @Yuvi-raj-P for your contribution.

filter-page

Timezone improvements

Images without timezones could previously show up incorrectly in the timeline if the server had a timezone (TZ=...) set. This has been fixed and can be corrected by running metadata extraction on all assets.

Deprecated release notes section

Future releases will now include a "Deprecated" section in the release notes, including details of API endpoints and other changes that will become breaking changes in a future release. Moving forward, we plan to use this section of the release notes as our primary communication method for these types of changes.

Refresh face detection

Assets now have a Refresh faces option to update the set of detected faces based on the current face detection threshold. Likewise, there is a new Refresh button for Face Detection in the Jobs page that does the same for all assets.

Importantly, this does not clear all recognized people like the All button (renamed to Reset). If you find that a different detection threshold works better for your library and want to apply that new value to existing assets, Refresh will simply add or remove faces to apply this change.

It will only ever delete faces detected through machine learning, not EXIF. Speaking of EXIF-sourced faces, they can now be used to recognize detected faces as a result of this feature. This means the facial recognition process can share the same people listed in face metadata instead of duplicating them.

Better JPEG compression

Immich now uses Jpegli, a new library leveraging the advancements of JPEG XL to shrink JPEG file size at the same (or higher) quality. This change narrows the gap between JPEG and WebP compression considerably, especially at high quality.

Multi-GPU support for ML

It is now possible for a single instance of the machine learning service to use more than one GPU. Previously, this required several services and a load balancer in front. See the documentation for instructions.

Support Immich

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

Cheers! 🍻

What's Changed

🚨 Breaking Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

Read more

Contributors

etnoy, C-Otto, and 19 other contributors
Loading
85 Join discussion

v1.117.0

03 Oct 02:14
@github-actions github-actions
v1.117.0
6b84624
Compare
Choose a tag to compare
v1.117.0

v1.117.0

Warning

Breaking changes

The image section of the config file structure for thumbnails and previews has changed. If you use a config file and set the image settings to custom values, these will be ignored until updated to the new structure.

…
"image": {
-  “previewFormat”: “jpeg”,
-  “previewSize”: 1440,
-  “quality”: 80,
-  “thumbnailFormat”: “webp”,
-  “thumbnailSize”: 250,
+  "thumbnail": {
+     "format": "webp",
+     "size": 250,
+     "quality": 80
+   },
+   "preview": {
+     "format": "jpeg",
+     "size": 1440,
+     "quality": 80
+   },
    "colorspace": "p3",
    "extractEmbedded": false
  }
…

Highlights

Welcome to release v1.117.0 of Immich. This release continues to bring bugfixes and additional enhancements to the app. Let's go over some of the highlights below:

  • Better folder checks
  • Download notifications (mobile)
  • Support and feedback links (web)
  • Upgrade history
  • Asset thumbnail improvements

Better folder checks

This release fixes a few more issues with the .immich related checks.

  • Ignore errors when .immich already exists, but mount checks aren't enabled
  • Add a docs page about System Integrity
  • Add an env option to skip mount checks (IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true)

Download notifications (mobile)

Downloads now show their progress and can be canceled

Support and feedback links (web)

Links have been added to the Immich web application to help users more easily find our documentation, source code, discord, etc. Also, third party packages have the option to additionally include their own links.

image

image

Upgrade history

Clicking on the server build number on the web will now also show upgrade history, in addition to other build information.

In the future we may look at combining this information with the new support/help modal.

Light Dark
image image

Asset thumbnail improvements

Combined jobs

Thumbnails are critical to keep Immich feeling snappy. We currently generate a "preview" (large), a "thumbnail" (small), and a "thumbhash" (very small) for each asset. Prior to this release each version for each asset was a separate job. Now they have been combined into a single job, per asset. This makes the jobs page much more accurate and useful. It also means thumbnails generate faster, and use less system resources (see below).

thumbnail-generation-memory-usage

In order from left to right:

  • Previews generation start on old version
  • Previews generation completed old version (starting thumbnails)
  • Thumbnail generation finished old version
  • Thumbnail generation started on new version
  • Thumbnail generation finished on new version

Common settings

Previews and thumbnails can now both set desired format, resolution, and quality settings.

image-settings

Support Immich

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

Cheers! 🍻

What's Changed

🚀 Features

🌟 Enhancements

🐛 Bug fixes

  • fix(server): "all" button for facial recognition deleting faces instead of unassigning them by @mertalev in #13042
  • fix(server): /search/random failing with certain options by @mertalev in #13040
  • fix(mobile): share to error by @alextran1502 in #13044
  • fix: deletedAt not set for offline assets during 1.116.0 migration by @zackpollard in #13086
  • fix(server): offline assets don't restore when coming back online by @zackpollard in #13087

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v1.116.2...v1.117.0

Contributors

C-Otto, zackpollard, and 6 other contributors
Loading
23 Join discussion

v1.116.2

27 Sep 18:44
@github-actions github-actions
v1.116.2
8bbcd5c
Compare
Choose a tag to compare
v1.116.2

v1.116.2

Hotfixes

  • Fixed an issue library jobs not working correctly

Support Immich

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

Cheers! 🍻

What's Changed

🐛 Bug fixes

  • fix: library pagination to 10k to avoid too many postgres query params by @zackpollard in #12993

📚 Documentation

Full Changelog: v1.116.1...v1.116.2

Contributors

zackpollard and bo0tzz
Loading

v1.116.1

27 Sep 15:52
@github-actions github-actions
v1.116.1
7c15e11
Compare
Choose a tag to compare
v1.116.1

v1.116.1

Hotfixes

  • Fixed an issue of putting the app in the background on the login screen, causing the signing progress to hang on the mobile app
  • Fixed an issue of incorrectly getting the original filename on iOS
  • Fixed handling of numeric hierarchical subject values in tags

Support Immich

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

Cheers! 🍻

What's Changed

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

  • docs: add clarity to non root user section by @GusPrice in #12956
  • refactor(docs): fix heading tag, update Vietnamese translation for image alt, formatting features table by @KD-MM2 in #12971
  • chore(Brazilian README): fix broken image links and update translation by @ryanrpj in #12980

New Contributors

Full Changelog: https://github.com/immich-app/immich/compare/v1.116.0...

Contributors

jrasm91, alextran1502, and 5 other contributors
Loading

v1.116.0

26 Sep 15:22
@github-actions github-actions
v1.116.0
60679a6
Compare
Choose a tag to compare
v1.116.0

v1.116.0

Highlights

Welcome to release v1.116.0 of Immich!

This release continues to focus on bug fixes, which is quite typical for us, especially after large releases. Highlights for this release include:

  • Improved.immich file boot checks
  • Improved external library scanning
  • Timezone improvements
  • Tag clean up job
  • Better person merge workflow
  • Improve settings pages (web)
  • Fixed possible startup failure due to .immich files
  • Serve style.json directly from tiles.immich.app
  • New "random" api for 3rd party apps
  • Notable fix: Uncaught error causes the hashing process to abort entirely in the mobile app

Issues with .immich files on boot in 1.115.0

There were a small number of users who experienced problems with booting Immich after upgrading to 1.115.0. This was due to the new .immich file checks that verify your library folders are still mounted and writable. If, and only if you had problems booting 1.115.0 that persist into 1.116.0 with an error of "Unable to write .immich file, already exists", you can fix this by stopping Immich and removing the .immich files in the UPLOAD_LOCATION subfolders (upload, library, thumbnails, etc). If you experience any further problems, please do contact us on discord or via a github discussion.

Improved external library scanning

The external library scan mechanism has been reduced from four seperate options, to one. There is now a single button "Scan" that will handle all cases. Files that are offline (deleted or missing) now get hidden from the timeline and will show in the trash folder. This will become a dedicated screen in a future release. If the file comes back online, then the assets will re-appear in the main timeline and albums they were in previously. If the asset is offline for longer than the trash duration set in the admin config, the assets will be removed from immich automatically

Timezone improvements

Previously, if the timezone of an asset was unknown, it would apply an arbitrary offset by assuming the time was UTC and adjusting it to the viewer's timezone. Now, a timezone will only be shown if it is known for the asset.

Before After
image image

Tag cleanup job

If you have tags with no assets in them, you can remove them by running the "Tag clean up" job
here.

image

Better person merge workflow

The merge page always uses the same direction to merge people together. The "source" gets merged into the "target". However, sometimes the target is an unnamed person. Now, in these situations, the merge direction is automatically reversed, leading to a better user experience.

Serve style.json directly from tiles.immich.app

Up to this release, the immich server served the style.json file. That file includes the styling of the map as well as the font/glyphs/tiles provider. However, this also means that tile server updates were always bound to immich server updates. With this change, we decouple the two by serving the (static)style.json file from the infrastructure we serve the map tiles. This is also in line with pretty much any other map/tile provider. This change will assist us in bringing map improvements to all users in the future, such as map localisation without having to manage multiple different immich versions.
However, note that this does not affect the ability to specify a different style.json URL in the admin settings.

UI improvement for settings pages

Each setting now has a new design accordion section with a distinguishable icon to help identify it easier as the options get longer. You can also search for the administration settings by their title and subtitle in your native language.

image

New "random" API

We are deprecating GET /assets/random in favor of POST /search/random, which works very similar to the other search endpoints. It includes more relations and filters. In the future, we plan to add an option to search and filter by a specific album ID.

Support Immich

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

Cheers! 🍻

What's Changed

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

...

Read more

Contributors

etnoy, zackpollard, and 18 other contributors
Loading
9 Join discussion