open-noodle/gallery v5.6.0-rc.0 on GitHub

⚠️ Release candidate — not for production. Please back up your database before testing.

📖 Full release notes, with screenshots →

Try it

Set IMMICH_VERSION=v5.6.0-rc.0 in your .env, then:

docker compose pull && docker compose up -d

Mobile: iOS · TestFlight · Android · APK (attached below)

What to test

🐾 Pet Recognition — new

Your dogs and cats become individual, nameable identities instead of one shared entry per species. It runs on three re-identification models we trained and published ourselves.

It is off by default, under Administration → Settings → Machine Learning Settings → Pet Recognition. Pet Detection must be enabled too, or recognition has nothing to work with.

Enabling it only affects newly uploaded photos. To bring your existing library in, Reset the Pet Recognition job under Administration → Jobs.
⚠️ Reset is destructive. It deletes every pet identity and every name you have given, then rebuilds. Worth doing once, early — not after you have named twenty pets. Reset while Pet Detection is off and you end up with no pets at all until you enable it and reset again.
Check that pets appear on People with a paw badge, and that naming, merging and hiding work the way they do for people.
Two same-breed, same-colour pets collapsing into one entry? Lower Maximum recognition distance (default 0.55). The reverse — one pet split across several entries — means raise it.
A pet in a photo you contributed to a Shared Space should appear on that space's People page.
Switching between the small / base / large models is as destructive as a reset, for the same reason: each model has its own embedding space.

🔍 Pet Detection now runs on RF-DETR, and records only cats and dogs

⚠️ If you ever changed the confidence threshold, check it now. It does not migrate. A 0.6 set for YOLO11 is roughly twice as strict under RF-DETR and will make it miss pets. The new default is 0.3.
Upgrading reprocesses nothing. Existing detections keep the old model's results until a Reset — including any bear / zebra / giraffe / elephant entries, which RF-DETR never produces and so will never correct on their own.
Birds, horses, sheep and cows are no longer recorded at all. They were only ever written to a shared per-species entry the People page never listed.

📁 Nested folders for Space albums — new

In the Albums tab of a Shared Space.

Create folders, nest them, drag albums into them, navigate with the breadcrumb.
Deleting a folder should promote its contents, not delete them — check the albums and subfolders survive.
Owners and Editors can create, rename and drag; Viewers should not see those controls.
Try the same on the mobile app.
Searching inside a Space flattens across folders rather than staying in the one you opened — that is deliberate.

👥 People / Pets filter

The All / People / Pets selector, on the personal People page and inside a Space, on web and mobile.

The choice persists — check it survives a refresh and applies on first paint rather than flashing the full list.
You should always be able to get back to All, even when the current filter matches nothing.

🔎 Search

New search-mode control: a chip inside the desktop search field, and a scrollable segmented rail under the modal input on narrower screens. Ctrl+/ still works.
"Search here" on an album, a Space timeline, a Space album and Photos — the search should stay scoped to where you started it.
Starting a new search should clear the previous results immediately, not leave the old photos on screen.

🕰️ Memories

Cards built from the same period should no longer share photos or covers.
Card titles should be in your app language, not English.
View in timeline on a Space photo should land in that Space, not your personal timeline.

Also worth a look

Downloading a Space album should include everyone's contributions, not just the owner's photos.
Hide from timeline now hides the photo for its own owner too, not just for everyone else.
Below 850px the content panel should keep its rounded gutter on all four sides.

Report issues on GitHub.

Full changelog: v5.5.0...v5.6.0-rc.0