Skip to content

Release Notes

You can test upcoming features and enhancements by changing the image tag from :latest to :preview and then following our update guide to download the newest image from Docker Hub and restart your instance.

Development Preview

Build 241121-7f3948f42

What's new?

We are currently upgrading our frontend component framework to a new major version. To avoid duplicate work and conflicting changes, development of new frontend functionality will continue after the upgrade has been completed. Learn more ›

September 15, 2024

Build 240915-e1280b2fb

This update includes improved HEIC file support for iOS 18 compatibility, updated dependencies and translations, UX enhancements, and fixes for recently discovered issues. Please note that a complete re-scan of your library is required to increase the GPS location accuracy of pictures, e.g. under Places. A big thank you to everyone who contributed and helped with testing! 🛰🌎

What's new?

July 11, 2024

Build 240711-2197af848

Our latest update adds support for single sign-on via OpenID Connect (OIDC). We would like to thank everyone who contributed to this, especially Timo Volkmann, who got things rolling and did much of the necessary work! 🌈

What's new?

May 31, 2024

Build 240531-60b3a4628

With this update, you can choose to install FFmpeg 7 for faster software video transcoding. You also get the latest translations contributed by our community as well as improved backup commands and configuration defaults.

What's new?

May 28, 2024

Build 240528-977d6c0de

This service release reduces the server load when downloading many files, expands the list of available config options, and gets you the latest translations contributed by our community.

What's new?

May 23, 2024

Build 240523-923ee0cf7

This update adds a scheduler so you can easily create database backups and re-index your library at regular intervals. It also includes many updated dependencies and support for ICC color profiles, which especially benefits Apple iPhone and professional users working with color spaces other than sRGB. 🎨

Important Changes

  • If you keep the default settings, daily database backups will be automatically created, with up to 3 backup files being retained. This is to prevent the available storage space from filling up. We recommend setting the corresponding config options before installing the update if you want to disable scheduled backups, keep more backup files, or prefer a specific time for creating backups. The previously available --disable-backups flag has been deprecated in favor of these finer-grained options.
  • In order to preserve ICC color profiles and reduce memory usage, new thumbnails will be generated with the libvips image processing library. You can run the photoprism thumbs -f command in a terminal to regenerate your existing thumbs as needed, or delete the storage/cache/thumbnails folder and then re-index your library. To continue using the native image processing library, set PHOTOPRISM_THUMB_LIBRARY to "imaging" in your compose.yaml or docker-compose.yml configuration file. If you build from source or use one of our binary installation packages, the system on which you build and/or run PhotoPrism must have libvips >= 8.10 installed.

What's new?

Missing user interface translations have been generated with the help of DeepL and Google Translate. Native speakers are welcome to help us improve them, if necessary.

April 20, 2024

Build 240420-ef5f14bc4

Our new stable release comes with a long list of indexing and security-related improvements. Most notably, we've added support for 2-Factor Authentication (2FA) to protect your account in case someone gains access to your password. As all security-related changes had to be thoroughly tested, this is one of the updates that were longer in the making. We appreciate your patience while we've been working on this and would like to thank everyone involved! 🔐

What's new?

Missing user interface translations have been generated with the help of DeepL and Google Translate. Native speakers are welcome to help us improve them, if necessary.

November 28, 2023

Build 231128-f48ff16ef

Our latest service release provides updated dependencies and fixes for recently discovered issues. In addition, official installation packages with binaries for Linux are now available as an alternative to our Docker images. Please note that only experienced users should choose this installation method, since these do not include all dependencies and need to be set up manually.

What's new?

October 21, 2023

Build 231021-9abea5b55

This update adds search filters for finding pictures by ISO number, focal length, aperture, and altitude. It also includes a number of user interface improvements, updated translations, as well as fixes for recently discovered issues. We would like to thank everyone who submitted pull requests, helped with testing, or contributed in other ways! ✨

What's new?

October 11, 2023

Build 231011-63f708417

This service release includes an updated ARMv7 build, a number of usability improvements requested by our community, and fixes for recently discovered issues. We would like to thank everyone involved!

What's new?

September 23, 2023

Build 230923-e59851350

Our latest release includes a redesigned Places view, with the search box moved to the top and a preview for selected clusters at the bottom. We've also added support for Samsung/Google Motion Photos, so you can view them like Apple Live Photos after re-indexing your library. Beyond those highlights, you'll get many usability improvements, new search filters, and fixes for recently discovered issues. A big thank you to everyone who contributed!

What's new?

July 19, 2023

Build 230719-73fa7bbe8

Our latest release includes new features and enhancements contributed by our community, a number of security improvements, as well as fixes for recently discovered issues. Thank you to everyone who submitted pull requests, helped with testing, signed up as a member, or contributed in other ways! We appreciate it very much.

What's new?

We recommend that you explicitly disable TLS by adding PHOTOPRISM_DISABLE_TLS: "true" to your compose.yaml or docker-compose.yml file when running PhotoPrism behind a reverse proxy. HTTPS could otherwise be accidentally enabled if a certificate matching the site URL is found or PHOTOPRISM_DEFAULT_TLS is set to "true".

June 25, 2023

Build 230625-17242fb07

This service release includes the latest translations contributed by our community, as well as fixes for recently discovered issues.

What's new?

June 15, 2023

Build 230615-90a18f6e7

This update includes new features and enhancements contributed by our community, as well as fixes for recently discovered issues. We would like to thank everyone involved!

What's new?

June 7, 2023

Build 230607-9e086c7eb

With this much anticipated update, our new high-resolution vector world map becomes available to all users. It also features a special terrain mode for mountain lovers, so you can view the "Satellite", "Outdoor" and "Topography" maps in 3D!

What's new?

PhotoPrism® Plus

June 3, 2023

Build 230603-378d4746a

This service release fixes recently discovered issues and improves compatibility with the upcoming MariaDB v11.0. If you are upgrading from MariaDB 10.x to 11.0, please make sure that you replace command: mysqld with command: (followed by the command flags) in your compose.yaml or docker-compose.yml file, otherwise the database server might fail to start. Thank you to everyone who contributed with pull requests, reported bugs, and helped us test the changes!

What's new?

PhotoPrism® Plus

May 13, 2023

Build 230513-0b780defb

As promised, this update makes hardware transcoding and many other config options available to all users. A big thank you to all of our contributors, members, and sponsors, whose generous support has been and continues to be essential to the success of the project!

What's new?

May 6, 2023

Build 230506-9de9a3540

This update resolves two recently reported issues and includes updated translations.

What's new?

May 4, 2023

Build 230504-cbf48798c

This service release makes the Nordic theme and the Hide People feature available to all users. It also changes the theme order in Settings so that the freely available themes come first.

What's new?

May 2, 2023

Build 230502-c405f6eff

With this major new release, you'll get a long list of new features and enhancements with a focus on performance, security, and file type support. In addition, our Plus Members can now register directly in the app to unlock additional features like vector graphics support and a new admin web UI for user and session management. Thank you to all contributors, members, and sponsors who made this possible!

What's new?

PhotoPrism® Plus

Our new Plus License is used for both the extensions we provide to our members and the standard Docker images available on Docker Hub. This allows us to bundle the extensions with the compiled application, while the Community Edition remains freely available under the terms of the GNU Affero General Public License (AGPL).

If you don't plan to use any additional features, you can alternatively use the "ce" tag instead of "latest" to get a slightly smaller Docker image distributed under the AGPL. Note that system dependencies and other third-party components included in this image are still subject to additional terms and conditions.

View Membership FAQ › View Plus License ›

November 18, 2022

Build 221118-e58fee0fb

This service release includes compatibility fixes for MariaDB 10.10, the latest translations, a new theme, and updated dependencies. We recommend not using the :latest tag for the MariaDB Docker image and to upgrade manually by changing the tag once we had a chance to test a new major version.

What's new?

November 17, 2022

Build 221117-3268c4de8

This update includes video transcoding improvements and the latest translations contributed by our community.

What's new?

November 16, 2022

Build 221116-122ebfb70

With this update you get the latest translations, updated dependencies, and two metadata bug fixes. Thanks to all who contributed!

What's new?

November 5, 2022

Build 221105-7a295cab4

This service release provides UX improvements for the photo editing dialog and includes the latest translations contributed by our community. Note that our guides now use the new docker compose command by default. If your server does not yet support it, you can still use docker-compose to start and stop your instance.

What's new?

November 4, 2022

Build 221104-20d180b21

A small update featuring improved NVIDIA GPU support, the latest translations contributed by our community, and updated dependencies.

What's new?

November 3, 2022

Build 221103-211eb36ea

With this update you'll get the latest translations contributed by our community, updated dependencies as well as a few minor bug fixes and improvements.

What's new?

November 2, 2022

Build 221102-905925b4d

Due to the many new features, enhancements and bug fixes, this is one of those updates that took longer to release. Before upgrading, please read the full release notes and note that this release does not yet include support for user roles other than Admin, as we need to specify, create and test each new role before we can release it. Once this is done, we will also provide additional user management documentation.

We've generated missing translations with the help of DeepL and Google Translate. Native speakers are invited to help us improve those if needed. A special thank you to everyone who contributed!

Breaking Changes

  • In order to improve security and compatibility, the default Docker image is now based on Ubuntu 22.04 LTS (Jammy Jellyfish) instead of Debian 12 (Bookworm). The entrypoint script has been updated to preserve group permissions required for hardware transcoding.
  • Session and user management have been re-implemented. If you are upgrading from a preview build, you will need to run the photoprism users reset --yes command in a terminal after the upgrade to recreate the new database tables so that they are compatible with the stable version. This will not affect your pictures or albums.
  • Upgrading from the last stable version should work without any problems. However, if you have already created additional accounts with the previously offered unofficial multi-user support, you will notice that only the main admin account is migrated automatically. Run photoprism users legacy in a terminal to display the legacy accounts so you can migrate them manually if needed.
  • Sharing link visitors can now see the picture locations in the regular album view and optionally on a map after clicking the link. Based on user feedback, we may add settings to hide the locations for enhanced privacy.
  • We recommend performing a full rescan after the upgrade to take advantage of new search filters and sort options.
  • Indexing is also necessary to find and view HEIC, DNG, and AVIF images that were previously unsupported or had errors. In some cases with incorrectly converted images, it may be necessary to recreate the JPEG sidecar files by running the photoprism convert -f command in a terminal before starting the rescan. To regenerate your thumbnails, run photoprism thumbs -f.

What's new?

September 1, 2022

Build 220901-f493607b0

With this update you get all the latest translations contributed by our community, mobile navigation enhancements, updated dependencies and, as usual, fixes for recently discovered issues. Thanks to everyone involved!

What's new?

July 30, 2022

Build 220730-0e1222c83

Fixes the activation of public mode with PHOTOPRISM_AUTH_MODE instead of PHOTOPRISM_PUBLIC.

What's new?

July 28, 2022

Build 220728-729ddd920

Includes indexing, metadata, and authentication enhancements, as well as updated translations.

What's new?

Breaking Changes

June 29, 2022

Build 220629-5d7448d2

With this update, you'll enjoy a much faster and smoother scrolling experience as well as direct streaming of OGV, VP8, VP9, AV1, WebM and HEVC videos if they do not exceed the configured bitrate limit. Special thanks to Heiko Mathes and Andre Carrera for their contributions!

June 17, 2022

Build 220617-0402b8d3

This update features updated translations as well as fixes for recently discovered issues.

June 14, 2022

Build 220614-dea9ff68

A small but important update that includes translations to Arabic, a migration fix for MariaDB, and many updated dependencies.

May 28, 2022

Build 220528-efb5d710

This update includes translations that were recently contributed via translate.photoprism.app. Missing translations were added by us using DeepL and Google Translate. Native speakers are invited to help improve those if needed. Thank you very much!

May 27, 2022

Build 220527-005770ca

This update improves navigation fonts and mobile submenu colors for light themes. We are also working to establish PhotoPrism+ as the name for our community membership and associated benefits. For this, membership information in the app, on our website, on GitHub Sponsors and Patreon is gradually being updated.

May 24, 2022

Build 220524-c76de0df

This service release fixes potential issues with our new Debian 12-based Docker image that shipped with the last update. These may have prevented users from deploying it without making changes to their environment. In our ongoing effort to improve usability and performance, we have also implemented a number of UX/UI optimizations, such as using the default operating system font instead of Google's Roboto.

Thank you to everyone who helped with testing, signed up as a member, or contributed in other ways! We appreciate it very much.

May 17, 2022

Build 220517-b9c68f8f

This update features search UX enhancements, a new Docker base image based on Debian 12 "Bookworm", as well as fixes for recently discovered issues. Front- and backend translations in numerous languages have been added and updated. Thanks to all involved!

March 2, 2022

Build 220302-0059f429

The Docker images for this release are based on Debian 11 "Bullseye" and include many updated dependencies such as Darktable 3.8. Behind the scenes, the build process has also been improved so that it will be easier to provide standalone packages in the future.

You can now join us on translate.photoprism.app to help translate the UI!

January 21, 2022

Build 220121-2b4c8e1f

We've generated missing translations with the help of DeepL and Google Translate. Native speakers are invited to help us improve those if needed. Learn how to contribute.

January 18, 2022

Build 220118-76c94a1f

January 7, 2022

Build 220107-f5b7ef83

Based on our zero bug policy, this update focuses on bug fixes, security, and UX enhancements for search filters, metadata, and the indexer. In addition, one of the merged pull requests may improve face recognition performance on smaller devices and with large libraries.

December 15, 2021

Build 211215-93b26f19

PhotoPrism is not directly affected by the Apache Log4j vulnerability. Logs may still contain messages that can cause harm if consumed by an unpatched Java application. As a precaution, this release includes additional rules and filters to validate user input.

December 10, 2021

Build 211210-2cb90e7e

Starting with this release, the regular multi-arch Docker image is 64-bit only. A 32-bit version of our stable release for older devices is offered separately. This frees up development and infrastructure resources with minimal impact.

December 3, 2021

Build 211203-fdb6b5e1

Since the funding goal required to make all features and maps generally available has not been reached, early-access features have been renamed to sponsor features in this update. Offline and high-resolution street maps remain free for everyone, while hybrid, topographic, and outdoor maps are now a member feature. We believe this is fair. A big thank you to all our sponsors and contributors!

November 30, 2021

Build 211130-13cfcf6d

For our sponsors and contributors:

  • UI: New Abyss and Gemstone dark themes 💎

November 28, 2021

Build 211128-7e8974fd

Official support for MySQL 8 is discontinued with this update as Oracle seems to have stopped shipping new features and enhancements. As a result, the testing effort required before each release is no longer feasible. We recommend upgrading to MariaDB 10.6 or later. PostgreSQL support is planned for 2022 without a specific release date yet.

November 27, 2021

Build 211127-86c43159

When possible, location estimates now include a latitude and longitude. Photos load faster when you open them in Places, and the viewer sorts them by distance. Time zone handling has been completely reworked, in particular for UTC. The Docker base image has been updated to Ubuntu 21.10, which ships with Darktable 3.6 among other updated dependencies.

For our sponsors and contributors:

October 18, 2021

Build 211018-e200f322

For our sponsors and contributors:

  • UI: New Vanta dark theme ✨

October 10, 2021

Build 211010-83b4f783

We've generated missing translations with the help of DeepL and Google Translate. Native speakers are invited to help us improve those if needed. Learn how to contribute.

October 9, 2021

Build 211009-d6cc8df5`

October 7, 2021

Build 211007-8f55d6f8

For our sponsors and contributors:

October 2, 2021

Build 211002-bf015326

September 25, 2021

Build 210925-96168e4b

May 23, 2021

Build 210523-b1856b9d

May 20, 2021

Build 210520-4b32bac7

May 19, 2021

Build 210519-24b5c7e6

May 18, 2021

Build 210518-80981c25

May 5, 2021

Build 210505-d3e53a89

April 26, 2021

Build 210426-da6e948f

April 22, 2021

Build 210422-97e75b04

February 22, 2021

Build 210222-ac5a9d5e

February 17, 2021

Build 210217-49039368

February 16, 2021

Build 210216-4939e36a

February 11, 2021

Build 210211-b9595dd4

February 8, 2021

Build 210208-9e10ba69

January 28, 2021

Build 210128-a82061e0

January 21, 2021

Build 210121-07e559df

January 20, 2021

Build 210120-e7cd5e9a

January 19, 2021

Build 210119-a5399f06

For our sponsors and contributors:

January 11, 2021

Build 210111-cc05c430

January 4, 2021

Build 210104-7f9e806a

January 2, 2021

Build 210102-af71e5f7

  • WebDAV: Uploads and other changes trigger auto indexing / importing
  • Config: Use random hash for improved preview token security
  • UX: Disabled page zoom so that app feels more native on mobile devices
  • UX: Reduced min password length to 4 characters
  • UX: Improved docker-compose.yml examples
  • UX: Reduced icon size in "add to album" dialog

December 31, 2020

Build 201231-8e22fbf8

  • Initial Stable Release

Getting Updates

Even when you use an image with the :latest tag, Docker does not automatically download new images for you. To update, you can either manually pull the newest image and restart, or set up a service like Watchtower to get automatic updates.

Learn more ›