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:
- Port alignment
- Remove deprecated API endpoints
- Remove deprecated
start.sharguments
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
...
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.
start.sh argumentsThe following docker commands have been removed:
start.sh immichstart.sh microservicesFollow the steps below to align docker-compose.yml with the default setup.
[!NOTE] These steps are only required if you still have the
immich-microservicessection in yourdocker-compose.ymlor didn't follow the previous instructions to remove the command section. If you don't have the mentioned content below, you can ignore this
docker-compose.ymlRemove 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" ]
- ...
immich-microservices containerRun docker compose down --remove-orphans after updating docker-compose.yml to remove the old immich-microservices container.
Some of the highlights for this release include the following:
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.
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.
<img width="350" alt="image" src="https://github.com/user-attachments/assets/8020ae55-8e79-4cf0-ba2c-54ac56a9acb8">
This new page allows users to quickly view, sort, search, filter, create, and manage albums.
<img width="350" alt="image" src="https://github.com/user-attachments/assets/d5782994-f0f8-481f-b89e-c12b498b90b3">
The library page now includes quick access buttons to various views, including
<p> <img width="350" alt="image" src="https://github.com/user-attachments/assets/4d676568-593f-493f-b11c-6cc109b693ec">
<img width="350" alt="image" src="https://github.com/user-attachments/assets/4250a994-84a0-4195-b9f9-6c21b422124b"> </p>
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.
<img width="350" alt="image" src="https://github.com/user-attachments/assets/c02b7f79-1b0f-4d36-96f4-ba5b0e998cb4">
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.
<img width="350" alt="filter-page" src="https://github.com/user-attachments/assets/3a34489a-f5cd-49a3-b960-459e97b563d0">
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.
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.
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.
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.
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.
<!-- Release notes generated using configuration in .github/release.yml at main -->
<p align="center"> <img src="https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExbjY2eWc5Y2F0ZW56MmR4aWE0dDhzZXlidXRmYWZyajl1bWZidXZpcyZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/87CKDqErVfMqY/giphy.gif" width="450" title="SUPPORT THE PROJECT!"> </p>
If you find the project helpful, you can support Immich by purchasing a product key at https://buy.immich.app.
Cheers! 🍻
<!-- Release notes generated using configuration in .github/release.yml at main -->
personIds and withPeople by @mertalev in https://github.com/immich-app/immich/pull/13254Full Changelog: https://github.com/immich-app/immich/compare/v1.117.0...v1.118.0