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 230924-ab3262a63

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 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: mariadbd in your 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 PhotoPrism+ extensions we provide to our members as well as the standard Docker image we distribute. This allows us to bundle the extensions, and other third-party components that we are not allowed to distribute under the AGPL, with the compiled application in the Docker image. The public source code, however, remains under the Open Source AGPL license. If you don't want additional features, you can alternatively use the "ce" tag instead of "latest" to get a smaller Docker image distributed under the AGPL license.

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 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 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.