<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://immich.app/blog</id>
    <title>Immich Blog</title>
    <updated>2023-12-29T15:14:29.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://immich.app/blog"/>
    <subtitle>Immich Blog</subtitle>
    <icon>https://immich.app/img/favicon.png</icon>
    <entry>
        <title type="html"><![CDATA[Immich Recap 2023]]></title>
        <id>https://immich.app/blog/2023/2023-recap</id>
        <link href="https://immich.app/blog/2023/2023-recap"/>
        <updated>2023-12-29T15:14:29.000Z</updated>
        <summary type="html"><![CDATA[Hi everyone,]]></summary>
        <content type="html"><![CDATA[<p>Hi everyone,</p><p>Alex from Immich here.</p><p>We are entering the last few weeks of 2023, and it has been quite a year for Immich. The project has grown so much in terms of users, developers, features, maturity, and the community around it. When I started working on Immich, it was simply a challenge for myself and an opportunity to learn new technologies, crafting something fun and useful for my wife during my free time to satisfy my urge to build and create things. I never thought it would become so popular and help so many people. At the end of the day, all we have is memory. I am proud that the team and I have created something to make storing and viewing those precious memories easier without restrictions and without sacrificing our privacy. As the year closes, here’s a recap of everything the project accomplished in 2023.</p><h1>Milestones</h1><ul><li>Public shared links</li><li>Favorites page</li><li>Immich turned 1</li><li>Material Design 3 on the mobile app</li><li>Auto-link LivePhotos server-side</li><li>iOS background backup</li><li>Explore page</li><li>CLIP search</li><li>Search by metadata</li><li>Responsive web app</li><li>Archive page</li><li>Asset descriptions</li><li>10,000 stars on GitHub</li><li>Manage auth devices</li><li>Map view</li><li>Facial recognition, clustering, searching, renaming, and person management</li><li>Partner sharing and unifying timeline between partners' users</li><li>Custom storage label</li><li>XMP sidecar reading</li><li>RAW file formats</li><li>Justified layout on the web</li><li>Memories</li><li>Multi-select via SHIFT</li><li>Android Motion Photos</li><li>360° Photos</li><li>Album description</li><li>Album performance improvements (time buckets)</li><li>Video hardware transcoding</li><li>Slideshow mode on the web</li><li>Configuration file</li><li>External libraries</li><li>Trash page</li><li>Custom theme</li><li>Asset Stacking</li><li>20,000 stars on GitHub</li><li>Shared album activity and comments</li><li>CLI v2</li><li>Down to 5 containers (from 8)</li></ul><h1>Fun Statistics</h1><ul><li>We have gone from the release version <code>1.41.0</code> to <code>1.90.0</code> at the time of writing. On average, we see a release every 7 days.</li><li>According to GitHub's metrics, the <code>immich-server</code> container image has been pulled almost <em>4 million</em> times.</li><li>According to mobile app store metrics, we have 22,000 installations on Android and 6700 installation units on iOS (opt-in only).</li><li>Immich is making around $1200/month on average from donations. (Thank you all so much!)</li><li>We were guests on two podcasts:<ul><li><a href="https://selfhosted.show/110" target="_blank" rel="noopener noreferrer">Self-hosted</a></li><li><a href="https://www.theverge.com/23938533/self-hosting-local-first-software-vergecast" target="_blank" rel="noopener noreferrer">The Vergecast</a></li></ul></li><li>There are over 4,500 members on the Discord server.</li><li>We have over 22,000 stars on the main GitHub repository, gaining 15,000 stars since January 2023.</li></ul><p>Diving into the next year, the team will continue to build on the foundation we have laid out over the past year, implementing more advanced features for searching, organizing, and sharing between users. Bugs will continue to be squashed and conquered. “Shit Alex wrote'' code will continue to be replaced by beautiful, clean code from Jason, Zack, Boet, Daniel, Osorin, Mert, Fynn, Marty, Martin, and Jonathan. The team has my eternal gratitude for creating a welcoming environment for new contributors, helping, teaching, and learning from each other. I’ve realized that hardly a day has gone by where the team hasn’t been in communication about Immich related topics over the past year.</p><p>My long-term goal is to help hone Immich into a diamond in the FOSS space, where the UI, UX, development experiences, documentation, and quality are at a high standard while remaining free for everybody to use.</p><p>I hope you enjoy Immich and have a happy and peaceful holiday.</p>]]></content>
        <author>
            <name>Alex Tran</name>
            <uri>https://github.com/alextran1502</uri>
        </author>
        <category label="update" term="update"/>
        <category label="recap-2023" term="recap-2023"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Immich Update - July 2023]]></title>
        <id>https://immich.app/blog/2023/07/29/update</id>
        <link href="https://immich.app/blog/2023/07/29/update"/>
        <updated>2023-07-29T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Hello, Immich fans, another month, another milestone. We hope you are staying cool and safe in this scorching hot summer across the globe.]]></summary>
        <content type="html"><![CDATA[<p>Hello, Immich fans, another month, another milestone. We hope you are staying cool and safe in this scorching hot summer across the globe.</p><p>Immich recently got some good recognition when getting to the front page of HackerNews, which helped to let more people know about the project's existence. The project will help more and more people find a solution to control the privacy of their most precious moments. And with the gain in popularity and recognition, we have gotten new users and more questions from the community than ever.</p><p>I want to express my gratitude to all the contributors and the community who have been tremendously helpful to new users' questions and provided technical support.</p><p>Below are the highlights of new features we added to the application over the past month, along with countless bug fixes and improvements across the board, from developer experience to resource optimization and UI/UX improvement. I hope you find these topics as exciting as I am.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="highlights">Highlights<a href="#highlights" class="hash-link" aria-label="Direct link to Highlights" title="Direct link to Highlights">​</a></h2><ul><li>Memories feature.</li><li>Facial recognition improvements.</li><li>Improvements on multi selection behavior on the web.</li><li>Shortcuts for common actions on the web.</li><li>Support viewer for 360-panorama photos.</li></ul><hr><h3 class="anchor anchorWithStickyNavbar_LWe7" id="memories-feature">Memories feature<a href="#memories-feature" class="hash-link" aria-label="Direct link to Memories feature" title="Direct link to Memories feature">​</a></h3><p>We've added the memory feature on the mobile app, so you can reminisce about your past memories.</p><iframe width="560" height="315" src="https://youtube.com/embed/c7OTl-RqNRE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><h3 class="anchor anchorWithStickyNavbar_LWe7" id="facial-recognition-improvements">Facial recognition improvements<a href="#facial-recognition-improvements" class="hash-link" aria-label="Direct link to Facial recognition improvements" title="Direct link to Facial recognition improvements">​</a></h3><p>Over the past few releases, we have added many UI improvements to the facial recognition feature to help you manage the recognized people better. Some of the highlights:</p><h4 class="anchor anchorWithStickyNavbar_LWe7" id="choose-a-new-feature-photo-for-a-person">Choose a new feature photo for a person.<a href="#choose-a-new-feature-photo-for-a-person" class="hash-link" aria-label="Direct link to Choose a new feature photo for a person." title="Direct link to Choose a new feature photo for a person.">​</a></h4><iframe width="560" height="315" src="https://youtube.com/embed/PmJp8DmSh1U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><h4 class="anchor anchorWithStickyNavbar_LWe7" id="hide-and-show-faces">Hide and show faces.<a href="#hide-and-show-faces" class="hash-link" aria-label="Direct link to Hide and show faces." title="Direct link to Hide and show faces.">​</a></h4><p>You can now select irrelevant faces to hide them. The hidden faces won’t be displayed in search results and the people section in the info panel.</p><h4 class="anchor anchorWithStickyNavbar_LWe7" id="merge-faces">Merge faces.<a href="#merge-faces" class="hash-link" aria-label="Direct link to Merge faces." title="Direct link to Merge faces.">​</a></h4><p>This is useful when you have multiple faces of the same person in your photos, and you want to merge them into one.</p><iframe width="560" height="315" src="https://youtube.com/embed/-Xskhw-vpc4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><p>We also added a nifty mechanism that when naming a face, similar names will prompt you a merge face option for the convenience.</p><iframe width="560" height="315" src="https://youtube.com/embed/XzE6wficbl4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><h3 class="anchor anchorWithStickyNavbar_LWe7" id="improvements-on-multi-selection-behavior-on-the-web">Improvements on multi selection behavior on the web<a href="#improvements-on-multi-selection-behavior-on-the-web" class="hash-link" aria-label="Direct link to Improvements on multi selection behavior on the web" title="Direct link to Improvements on multi selection behavior on the web">​</a></h3><p>We have added a new multi selection behavior on the web to help you select multiple items easier. You can now select a range of photos and videos by holding the <code>Shift</code> key.</p><iframe width="560" height="315" src="https://youtube.com/embed/e_SiuHpVnmM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><h3 class="anchor anchorWithStickyNavbar_LWe7" id="shortcuts-for-common-actions-on-the-web">Shortcuts for common actions on the web.<a href="#shortcuts-for-common-actions-on-the-web" class="hash-link" aria-label="Direct link to Shortcuts for common actions on the web." title="Direct link to Shortcuts for common actions on the web.">​</a></h3><p>Some of us only navigate the world and the web with a keyboard (looking at you, Vim and Emacs users). So it would take away the sacred weapon of choice to require many clicks to perform repetitive actions. So we added quick shortcuts for the following action on the web.</p><img loading="lazy" src="/assets/images/web-shortcuts-panel-4cf8bf03577e42eb44c6547011426374.png" width="100%" style="border-radius:25px" alt="Dot Env Example" class="img_ev3q"><h3 class="anchor anchorWithStickyNavbar_LWe7" id="support-viewer-for-360-panorama-photos">Support viewer for 360-panorama photos.<a href="#support-viewer-for-360-panorama-photos" class="hash-link" aria-label="Direct link to Support viewer for 360-panorama photos." title="Direct link to Support viewer for 360-panorama photos.">​</a></h3><p>Photos with the EXIF property of <code>ProjectionType</code> will now have a special viewer on the web to view all the angles of the panorama.</p><p>The thumbnail of the 360 degrees panoramas will have a special icon on the top right of the thumbnail</p><img loading="lazy" src="https://github.com/immich-app/immich/assets/61410067/728ca1b0-375c-4631-8081-a609843e702f" width="50%" style="border-radius:25px" alt="Dot Env Example" class="img_ev3q"><p>Panorama in the detail view</p><img loading="lazy" src="https://github.com/immich-app/immich/assets/61410067/3c89dac4-395d-45fa-9bc5-98a6248fd476" width="50%" style="border-radius:25px" alt="Dot Env Example" class="img_ev3q"><hr><p>Thank you, and I am asking for your support for the project. I hope to be a full-time maintainer of Immich one day to dedicate myself to the project as my life's work for the community and my family. You can find the support channels below:</p><ul><li>Monthly donation via <a href="https://github.com/sponsors/alextran1502" target="_blank" rel="noopener noreferrer">GitHub Sponsors</a></li><li>One-time donation via <a href="https://github.com/sponsors/alextran1502?frequency=one-time&amp;sponsor=alextran1502" target="_blank" rel="noopener noreferrer">GitHub Sponsors</a></li><li><a href="https://liberapay.com/alex.tran1502/" target="_blank" rel="noopener noreferrer">Liberapay</a></li><li><a href="https://www.buymeacoffee.com/altran1502" target="_blank" rel="noopener noreferrer">buymeacoffee</a></li><li>Bitcoin: 1FvEp6P6NM8EZEkpGUFAN2LqJ1gxusNxZX</li><li>Give a project a star - the contributors love gazing at the stars and seeing their creations shining in the sky.</li></ul><p>Join our friendly <a href="https://discord.gg/D8JsnBEuKb" target="_blank" rel="noopener noreferrer">Discord</a> to talk and discuss Immich, tech, or anything</p><p>Cheer!</p><p>Until next time!</p><p>Alex</p>]]></content>
        <author>
            <name>Alex Tran</name>
            <uri>https://github.com/alextran1502</uri>
        </author>
        <category label="update" term="update"/>
        <category label="v1.64.0-v1.71.0" term="v1.64.0-v1.71.0"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Immich Update - June 2023]]></title>
        <id>https://immich.app/blog/2023/06/24/update</id>
        <link href="https://immich.app/blog/2023/06/24/update"/>
        <updated>2023-06-24T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Hello everybody, Alex here!]]></summary>
        <content type="html"><![CDATA[<p>Hello everybody, Alex here!</p><p>I am back with another update on Immich. It has been only a month since my last update (May 18th, 2023), but it seems forever. I think the rapid releases of Immich and the amount of work make the perspective of time change in Immich’s world. We have some exciting updates that I think you will like.</p><p>Before going into detail, on behalf of the core team, I would like to thank all of you for loving Immich and contributing to the project. Thank you for helping me make Immich an enjoyable alternative solution to Google Photos so that you have complete control of your data and privacy. I know we are still young and have a lot of work to do, but I am confident we will get there with help from the community. I appreciate all of you from the bottom of my heart!</p><p>And now, to the exciting part, what is new in Immich’s world?</p><ul><li>Initial support for existing gallery.</li><li>Memory feature.</li><li>Support XMP sidecar.</li><li>Support more raw formats.</li><li>Justified layout for web timeline and blurred thumbnail hash.</li><li>Mechanism to host machine learning on a completely different machine.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="support-for-existing-gallery">Support for existing gallery<a href="#support-for-existing-gallery" class="hash-link" aria-label="Direct link to Support for existing gallery" title="Direct link to Support for existing gallery">​</a></h2><p>I know this is the most controversial feature when it comes to Immich’s way of ingesting photos and videos. For many users, having to upload photos and videos to Immich is simply not working. We listen, discuss, and digest this feature internally more than you imagine because it is not a simple feature to tackle while keeping the performance and the user experience at the top level, which is Immich’s primary goal.</p><p>Thankfully, we have many great contributors and developers that want to make this come true. So we came up with an initial implementation of this feature in the form of a supporting read-only gallery.</p><p>To be concise, Immich can now read in the gallery files, register the path into the database, and then generate necessary files and put them through Immich’s machine learning pipeline so you can use all the goodness of Immich without the need to upload them. Since this is the initial implementation, some actions/behavior are not yet supported, and we aim to build toward them in future releases, namely:</p><ul><li>Assets are not automatically synced and must instead be manually synced with the CLI tool.</li><li>Only new files that are added to the gallery will be detected.</li><li>Deleted and moved files will not be detected.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="memory-feature">Memory feature<a href="#memory-feature" class="hash-link" aria-label="Direct link to Memory feature" title="Direct link to Memory feature">​</a></h2><p>This is considered a fun feature that the team and I wanted to build for so long, but we had to put it off because of the refactoring of the code base. The code base is now in a good enough form to circle back and add more exciting features.</p><p>This memory feature is very much similar to GPhotos' implementation of “x years since…”. We are aiming to add more categories of memories in the future, such as “Spotlight of the day” or “Day of the Week highlights”</p><iframe width="560" height="315" src="https://www.youtube.com/embed/j5XZKvViPew" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><p>This feature is now available on the web and will be ported to the mobile app in the near future.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="support-xmp-sidecar">Support XMP Sidecar<a href="#support-xmp-sidecar" class="hash-link" aria-label="Direct link to Support XMP Sidecar" title="Direct link to Support XMP Sidecar">​</a></h2><p>Immich can now import/upload XMP sidecars from the CLI and use the information as the metadata of assets.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="support-more-raw-formats">Support more raw formats.<a href="#support-more-raw-formats" class="hash-link" aria-label="Direct link to Support more raw formats." title="Direct link to Support more raw formats.">​</a></h2><p>With the recent updates on the dependencies of Immich, we are now extending and hardening support for multiple raw formats. So users with DSLR or mirrorless cameras can now upload their original files to Immich and have them displayed in high-quality thumbnails on the web and mobile view.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="justified-layout-for-web-timeline-and-blurred-thumbnail-hash">Justified layout for web timeline and blurred thumbnail hash<a href="#justified-layout-for-web-timeline-and-blurred-thumbnail-hash" class="hash-link" aria-label="Direct link to Justified layout for web timeline and blurred thumbnail hash" title="Direct link to Justified layout for web timeline and blurred thumbnail hash">​</a></h2><p>This is an aesthetic improvement in user experience when browsing the timeline. Photos and videos are now displayed correctly with perspective orientation, making the browsing experience more pleasurable.</p><p>To further improve the browsing experience, we now added a blur hash to the thumbnail, so the transition is more natural with a dreamy fade in effect, similar to how our brain goes from faded to vivid memory</p><iframe width="560" height="315" src="https://www.youtube.com/embed/b95FLmGHRFc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"></iframe><h2 class="anchor anchorWithStickyNavbar_LWe7" id="hosting-machine-learning-container-on-a-different-machine">Hosting machine learning container on a different machine<a href="#hosting-machine-learning-container-on-a-different-machine" class="hash-link" aria-label="Direct link to Hosting machine learning container on a different machine" title="Direct link to Hosting machine learning container on a different machine">​</a></h2><p>With more capabilities Immich is building toward, machine learning will get more powerful and therefore require more resources to run effectively. However, we understand that users might not have the best server resources where they host the Immich instance. Therefore, we changed how machine learning interacts and receives the photos and videos to run through its inference pipeline.</p><p>The machine learning container is now a headless system that can run on any machine. As long as your Immich instance can communicate with the system running the machine learning container, it can send the files and receive the required information to make Immich powerful in terms of searching and intelligence. This helps you to utilize a more powerful machine in your home/infrastructure to perform the CPU-intensive tasks while letting Immich only handle the I/O operations for a pleasant and smooth experience.</p><hr><p>So, those are the highlights for the team and the community after a busy month. There are a lot more changes and improvements. I encourage you to read some release notes, starting from version <a href="https://github.com/immich-app/immich/releases/tag/v1.57.0" target="_blank" rel="noopener noreferrer">v1.57.0</a> to now.</p><p>Thank you, and I am asking for your support for the project. I hope to be a full-time maintainer of Immich one day to dedicate myself to the project as my life works for the community and my family. You can find the support channels below:</p><ul><li>Monthly donation via <a href="https://github.com/sponsors/alextran1502" target="_blank" rel="noopener noreferrer">GitHub Sponsors</a></li><li>One-time donation via <a href="https://github.com/sponsors/alextran1502?frequency=one-time&amp;sponsor=alextran1502" target="_blank" rel="noopener noreferrer">GitHub Sponsors</a></li><li><a href="https://liberapay.com/alex.tran1502/" target="_blank" rel="noopener noreferrer">Liberapay</a></li><li><a href="https://www.buymeacoffee.com/altran1502" target="_blank" rel="noopener noreferrer">buymeacoffee</a></li><li>Bitcoin: 1FvEp6P6NM8EZEkpGUFAN2LqJ1gxusNxZX</li><li>Give a project a star - the contributors love gazing at the stars and seeing their creations shining in the sky.</li></ul><p>Join our friendly <a href="https://discord.gg/D8JsnBEuKb" target="_blank" rel="noopener noreferrer">Discord</a> to talk and discuss Immich, tech, or anything</p><p>Cheer!</p><p>Until next time!</p><p>Alex</p>]]></content>
        <author>
            <name>Alex Tran</name>
            <uri>https://github.com/alextran1502</uri>
        </author>
        <category label="update" term="update"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Release v1.36.0]]></title>
        <id>https://immich.app/blog/release-1-36</id>
        <link href="https://immich.app/blog/release-1-36"/>
        <updated>2022-11-10T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Hello everyone, it is my pleasure to deliver the new release of Immich to you. The team has been working hard to bring you the new features and improvements. This release includes some big features that the community has been asking since the beginning of Immich. We hope you will enjoy it.]]></summary>
        <content type="html"><![CDATA[<p>Hello everyone, it is my pleasure to deliver the new release of Immich to you. The team has been working hard to bring you the new features and improvements. This release includes some big features that the community has been asking since the beginning of Immich. We hope you will enjoy it.</p><p>Some notable features are:</p><ul><li><a href="#livephoto-ios-support-">OAuth integration</a></li><li><a href="#oauth-integration-">LivePhoto support on iOS</a></li><li>User config system</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="livephoto-ios-support-">LivePhoto iOS Support 🎉<a href="#livephoto-ios-support-" class="hash-link" aria-label="Direct link to LivePhoto iOS Support 🎉" title="Direct link to LivePhoto iOS Support 🎉">​</a></h2><p>LivePhoto on iOS is now supported in Immich.</p><p>The motion part will now be uploaded and can be played on the mobile app and the web.</p><div class="theme-admonition theme-admonition-caution alert alert--warning admonition_LlT9"><div class="admonitionHeading_tbUL"><span class="admonitionIcon_kALy"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</div><div class="admonitionContent_S0QG"><ul><li>The server and the app has to be on version <strong>1.36.x</strong> for the application to work correctly.</li><li>Previous uploaded photos will not be updated automatically, you will have to remove and reupload them if you want to keep the LivePhoto functionality.</li></ul></div></div><img loading="lazy" src="https://media.giphy.com/media/fTrGceZd7t1ewi8ESc/giphy.gif" width="100%" style="border-radius:10px;box-shadow:rgba(9, 30, 66, 0.25) 0px 1px 1px, rgba(9, 30, 66, 0.13) 0px 0px 1px 1px" title="LivePhoto playback on the web" class="img_ev3q"><h2 class="anchor anchorWithStickyNavbar_LWe7" id="oauth-integration-">OAuth Integration 🎉<a href="#oauth-integration-" class="hash-link" aria-label="Direct link to OAuth Integration 🎉" title="Direct link to OAuth Integration 🎉">​</a></h2><p>I want to borrow this chance to express my gratitude to <a href="https://github.com/EnricoBilla" target="_blank" rel="noopener noreferrer">@EnricoBilla</a>, who has been the trailblazer for this feature since the beginning days of Immich. His PR has sparked ideas, suggestions, and discussion among the team member on how to integrate this feature successfully into the app. Thank you so much for your work and your time.</p><p>OAuth is now integrated into the system. Please follow the guide <a href="https://immich.app/docs/usage/oauth" target="_blank" rel="noopener noreferrer">here</a> to set up your OAuth integration</p><p>After setting up the correct environment variables in the <code>.env</code> file, as shown below</p><table><thead><tr><th>Key</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td>OAUTH_ENABLED</td><td>boolean</td><td>false</td><td>Enable/disable OAuth2</td></tr><tr><td>OAUTH_ISSUER_URL</td><td>URL</td><td>(required)</td><td>Required. Self-discovery URL for client</td></tr><tr><td>OAUTH_CLIENT_ID</td><td>string</td><td>(required)</td><td>Required. Client ID</td></tr><tr><td>OAUTH_CLIENT_SECRET</td><td>string</td><td>(required)</td><td>Required. Client Secret</td></tr><tr><td>OAUTH_SCOPE</td><td>string</td><td>openid email profile</td><td>Full list of scopes to send with the request (space delimited)</td></tr><tr><td>OAUTH_AUTO_REGISTER</td><td>boolean</td><td>true</td><td>When true, will automatically register a user the first time they sign in</td></tr><tr><td>OAUTH_BUTTON_TEXT</td><td>string</td><td>Login with OAuth</td><td>Text for the OAuth button on the web</td></tr></tbody></table><div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockTitle_Ktv7">Authentik Example</div><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#F8F8F2"><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OAUTH_ENABLED</span><span class="token operator">=</span><span class="token plain">true</span><br></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OAUTH_ISSUER_URL</span><span class="token operator">=</span><span class="token plain">http://10.1.15.216:9000/application/o/immich-test/</span><br></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OAUTH_CLIENT_ID</span><span class="token operator">=</span><span class="token plain">30596v8f78a4b6a97d5985c3076b6b4c4d12ddc33</span><br></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OAUTH_CLIENT_SECRET</span><span class="token operator">=</span><span class="token plain">50f1eafdec353b95b1c638db390db4ab67ef035a51212dbec2f56175e2eb272b5d572c099176e6fe116ecf47ffdd544bgdb9e2edc588307ee0339d25eeccd88</span><br></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OAUTH_BUTTON_TEXT</span><span class="token operator">=</span><span class="token plain">Login with Authentik</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>The web will have the option to sign in with OAuth.</p><img loading="lazy" src="https://user-images.githubusercontent.com/27055614/202923726-f43fa148-47f5-4182-8f29-b0b87e4586fa.png" width="50%" title="Web Sign in with OAuth" style="border-radius:10px;box-shadow:rgba(9, 30, 66, 0.25) 0px 1px 1px, rgba(9, 30, 66, 0.13) 0px 0px 1px 1px" class="img_ev3q"><p>The mobile app will check if the server has OAuth enabled before displaying the OAuth
sign-in button.</p><img loading="lazy" src="https://media.giphy.com/media/3iy3SaNkVYtlkEiw06/giphy.gif" title="Mobile sign in with OAuth" style="border-radius:10px;box-shadow:rgba(9, 30, 66, 0.25) 0px 1px 1px, rgba(9, 30, 66, 0.13) 0px 0px 1px 1px" class="img_ev3q"><h2 class="anchor anchorWithStickyNavbar_LWe7" id="support">Support<a href="#support" class="hash-link" aria-label="Direct link to Support" title="Direct link to Support">​</a></h2><img loading="lazy" src="https://media.giphy.com/media/LStqgGESXW8XnuCv5y/giphy.gif" width="300" style="border-radius:10px;box-shadow:rgba(9, 30, 66, 0.25) 0px 1px 1px, rgba(9, 30, 66, 0.13) 0px 0px 1px 1px" title="Support the project" class="img_ev3q"><p>If you find the project helpful and it helps you in some ways, you can support the project <a href="https://github.com/sponsors/alextran1502?frequency=one-time&amp;sponsor=alextran1502" target="_blank" rel="noopener noreferrer">one time</a> or <a href="https://github.com/sponsors/alextran1502" target="_blank" rel="noopener noreferrer">monthly</a> from GitHub Sponsor</p><p>It is a great way to let me know that you want me to continue developing and working on this project for years to come.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="details">Details<a href="#details" class="hash-link" aria-label="Direct link to Details" title="Direct link to Details">​</a></h2><p>For more details, please check out the <a href="https://github.com/immich-app/immich/releases/tag/v1.36.0_55-dev" target="_blank" rel="noopener noreferrer">release note</a></p>]]></content>
        <author>
            <name>Alex Tran</name>
            <uri>https://github.com/alextran1502</uri>
        </author>
        <category label="release" term="release"/>
    </entry>
</feed>