v2.0.0 - Stable Release

[alextran1502]

v2.0.0 - Stable Release

Welcome to the release v2.0.0 of Immich. This release marks the first stable version of Immich. You can read our announcement blog post here to learn what stable means for Immich, what you can expect from a stable version, along with our future plans. Of course, it wouldn't be complete without a few surprises.

To update to this version, no special steps are required. Compose pull and compose up, and you are now on v2.0.0. Additionally, there are a few noteworthy items that we have been working on in preparation for the stable release:

• New homepage
• New API documentation
• New community metrics

Stable Release Live Stream and Video

We'll be hosting a Q&A livestream on October 2nd, 2025 at 6 PM UTC. You can submit your questions here and subscribe for notifications when the livestream starts here on YouTube.

New Merch and DVD

To celebrate this release, we want to capture this moment in a nostalgic form, reminiscent of how software was distributed in our childhood - on a CD (or DVD, in this “case”). Introducing Immich Stable in physical form! You can find the link to the disk here

The disk comes with a fully bootable Immich instance, featuring a selection of curated photos chosen by the team. You can purchase the disk from our merch store, along with a client or server product key, to support and celebrate this milestone with us.

The merch store is also updated with retro-styled Immich designs, check it out in https://immich.store

New homepage

The https://immich.app/ website has been recently updated. It’s been rewritten with our very own UI component library, and includes a blog with a few initial posts, including one about the new mobile sync implementation. Existing documentation has been moved to https://docs.immich.app/.

Better API documentation

We’re also happy to announce a new version of our API documentation, which is now live at https://api.immich.app/. The new docs include more information about authentication, authorization & permissions, a command palette for quick navigation (press / or ctrl+k), and a built-in method to view live results.

New community metrics

The https://data.immich.app/ website has also been updated to include new community metrics that show member growth on our subreddit and discord server.

What's Changed

🐛 Bug fixes

• fix: show un-hashed remainder assets by @shenlong-tanwen in fix: show un-hashed remainder assets #22492
• fix(server): Revert update libmimalloc path (fix(server): update libmimalloc path #22345) by @alextran1502 in fix(server): Revert update libmimalloc path (#22345) #22526
• fix: missing email button padding by @Funk66 in fix: missing email button padding #22529

Full Changelog: v1.144.1...v2.0.0

[SandiyosDev]

holy moly

[aaronliu0130]

Main thread: #22546

[lucky-verma]

Congrats, huge milestone!!

[Turbocat6413]

Congratulations!!!

[wherelse]

Good news for immich, Congratulation~

[sampittko]

Exciting times!

[DanielBCoffaro]

Absolutely awesome! Thank you for creating this, it's fantastic!

[GiorgioMendieta]

This is historic, thanks to every contributor for their hard work that helped make it to the stable release ! 🥳🎉

[loscati]

Congrats! Thanks for your work!

[nishanthc]

I was here.

[tiiins]

You all did a really great job! Congratulations! 🎉

[MyAifred]

谢谢您

[Gliese-667]

Congratulations everyone and thanks for all that you do!

[Handkep]

Damn. Thats very nice!! Thanks to everyone who put their hard work in to this project!! Now its time to buy a licence!!
(i was here :))

[LittleNewton]

On each upgrade of Immich, the outcome feels somewhat unpredictable.
For me, v2.0-stable does not provide the level of stability I would expect.

I understand that hot-patch versions (e.g., v2.0.1) are usually released afterwards to address these issues. However, since the container images of immich/immich-dl are quite large, releasing patches at such a high frequency may not be the most efficient approach, as it leads to unnecessary resource consumption.

Perhaps it would be worth considering a lighter-weight update strategy, or a way to decouple smaller fixes from the large container image, to improve both stability and efficiency.

[bo0tzz]

@LittleNewton Please create a Q&A thread with details about your setup, what you're seeing there is unusual and tends to indicate a problem with your docker setup.

[aaronliu0130]

Try using the migration job.

[h45h74x]

Congratulations and thank you for your awesome work! 🎉🎉🎉

[nckrwlmn]

What exactly is a bootable cd? How is it booting? Is it an OS?

[aaronliu0130]

That's what the setup instructions say.

[nckrwlmn]

So they quietly just made an OS? can it be installed standalone on a vm?

[bo0tzz]

No, we didn't make an OS, it's just Alpine Linux. This isn't meant to be installed, it's just a live boot to try Immich out and mostly just for a bit of fun.

[vitormarcal]

An RSS feed would be a very welcome addition to the blog.It makes following updates much easier.

[w00tlarr]

Congratulations! Been an Immich user since Fall of 2022. Keep up the awesome support and milestones.

[nmorey]

Will there be a v2.x.x or v2.0.x tags on dockerhub so we can update images automatically knowing compatibility is maintained ?

[hexxone]

Thank you to the Immich team for consistently fulfilling their promises. This is by far the easiest and nicest software I have self-hosted, with a very good UI and performance.

Even this major upgrade worked flawlessly with just a 'docker compose pull'. I know of many worse pieces of software in this regard — for example, the PostgreSQL database does not support the automatic updating of major versions. I have not regretted supporting you financially so far!

[fthffs]

Congrats! Thanks for your work, much appreciated.

[yankeguo]

Congrats

[benjamindaines]

Aye congrats! Saw the stream on Louis's channel. However..... you say no special steps are required to update, but..... I assure you, special steps are my life 😆😆

What recommended steps do you recommend for upgrading from 1.132.0? I'll wait for a few answers before pulling the trigger. My compose file is pretty old as well.... thought hasn't caused me any issues so far.