Release Notes¶

Back us on Patreon or GitHub Sponsors. Your continued support helps us provide regular updates and services like world maps. Thank you! 💜

You can test new features by changing the image tag in your docker-compose.yml from :latest to :preview, then pulling the most recent image, and finally restarting your instance.

Development Preview¶

Build 221129-51aae94e6

What's new?

UI: Updated "Electra" theme and removed "Seaweed"
Videos: Improved player compatibility with browser plugins
Albums: Double quotes in titles are replaced with Unicode instead of single quotes
Index: Improved query performance when flagging hidden files
Config: Custom template path is not searched for files if not specified
Translations: Updated Bulgarian, Chinese (traditional), Estonian, German, and Ukrainian

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?

UI: Added "Electra" theme
MariaDB: Compatibility fixes for version 10.10
Translations: Updated Czech and Estonian

November 17, 2022¶

Build 221117-3268c4de8

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

What's new?

Videos: Fixed installation of Intel Quick Sync drivers for hardware transcoding
Videos: Added .m2ts to known file extensions
Translations: Updated Chinese (Traditional) and Estonian

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?

Metadata: Bad Unicode strings are sanitized automatically
Metadata: UTC can be overridden by local time with unknown zone
MariaDB: Unsupported versions are allowed in "unsafe" mode
Translations: Added Estonian
Translations: Updated Polish, Italian, Korean, Romanian, and Chinese (Traditional)

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?

UX: Improved layout of form fields in photo edit dialog
Account: Disabled "gender" dropdown when busy or in demo mode
Docker: Changed "docker-compose" command to "docker compose"
Translations: Updated Estonian, Hungarian, and Russian

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?

NVIDIA: Added a ready-to-use docker-compose.yml config example
NVIDIA: Updated FFmpeg parameters for hardware video transcoding
NVIDIA: Updated install-gpu.sh script and related documentation
Translations: Updated Chinese

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?

Index: Paths starting with _. and __ like __MACOSX are ignored
Config: Updated new trusted proxy header options and command help
MariaDB: Improved server version check on startup
Security: Go has been upgraded to v1.19.3, which includes security fixes
Translations: Updated Chinese, French, Norwegian Bokmål, and Romanian

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?

Auth: Session and user management have been re-implemented
Auth: API has been improved to prevent unnecessary re-logins
Auth: User interface routes have been prefixed with /library
UX: Scroll position is restored again when navigating back
UX: Loading screen and mobile toolbar menu have been redesigned
UX: Improved user interface styles for RTL languages
Search: Added city:... and state:... to filter by location details
Search: Results can now also be sorted by "File Size" and "Video Duration"
Albums: Added breadcrumbs to navigate back on large screens
Albums: Deselected labels are ignored when adding photos by label
HEIC: Added support for Sony's .HIF file extension
HEIC: Updated heif-convert tool to fix conversion problems
AVIF: Added support for the AV1 Image File Format
RAW: Upgraded Darktable from v3.8.1 to v4.0.1 (AMD64 only)
ProRAW: JPEGs embedded in .DNG files can be searched and viewed
Videos: Added VAAPI hardware AVC encoder support
Index: Delayed RAW file format check to improve indexing performance
Import: Selection of a source folder with dots in its name is now possible
Import: Related original names are indexed in addition to the main filename
Settings: Services cannot be managed in public mode to increase security
Backups: Worker no longer recreates all album YAML files on every run
Metadata: Added more place names with known countries
Metadata: Default to UTC when reading time from XMP file
Config: Increased default resolution limit from 100 to 150 MP
Config: imprint info text option has been renamed to legal-info
SQLite: Added busy timeout preset to reduce locking errors when indexing
MariaDB: Startup fails with an error message if an unsupported version is used
Docker: Default image is based on Ubuntu 22.04 LTS (Jammy Jellyfish)
Docker: Switched from gosu to setpriv in entrypoint.sh script
Security: New files are created without execution permission
Security: Go has been upgraded to v1.19.2, which includes security fixes
Translations: Added Persian
Translations: Updated Chinese, Dutch, Finnish, French, German, Spanish, and many more

September 1, 2022¶

Build 220901-f493607b0

With this update you get all the latest translations contributed by our community, mobile navigation enhancements, upgraded 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?

Auth: Activate public mode via PHOTOPRISM_AUTH_MODE="public"

July 28, 2022¶

Build 220728-729ddd920

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

What's new?

Library: Added support for indexing and importing symbolically linked files
Thumbs: Creating redundant JPEG files is skipped to save disk space
Zip: Improved file system rights detection and temporary file handling
Metadata: Creation time is extracted from DateTimeCreated, if available
Metadata: Unknown values are ignored when parsing timestamps
Purge: Fixed SQL error when the photo ID of a file is missing
Cleanup: Improved logging when deleting related sidecar files
Config: Added PHOTOPRISM_AUTH_MODE option to select authentication mode
Config: Improved inline docs in docker-compose.yml examples
Build: Updated Go to v1.18.4, which includes a number of security and compiler fixes
Translations: Added Greek

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.

Security: Upgraded Go to v1.18.3, which includes TLS and validation fixes
MariaDB: Removed migration that could corrupt photo descriptions in the index
Translations: Added Arabic, updated Danish and Polish

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, sponsorship 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 sponsor, 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.

Auth: New login screen with more space for buttons, links, and legal information
Metadata: Redesigned file details tab in the edit dialog
Metadata: Support for Zulu formatted timestamps in Exiftool JSON and XMP
Sharing: Fixed upload of complete albums via WebDAV
Sharing: Manual WebDAV upload of video and RAW files
iOS: Fixed multi-select via long touch in Safari PWA mode
API: Added cache control header for faster thumbnail loading
Config: Simplified configuration of Unix domain socket database connections
Config: Added --imprint and --imprint-url to display legal information in the footer
Docker: Automatic installation of compatible CPU and GPU drivers
Translations: Updated all front- and backend locales

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.

Minimum memory requirements have been reduced to 3 GB
Photos: Fixed buttons in full screen view
People: Fixed typo that prevented face matching optimization
Moments: Improved update performance on MariaDB
Translations: Pre-translated missing UI messages

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.

People: Improved update performance on MariaDB
People: Improved contrast of person selection menu
Albums: Private pictures are excluded from download as zip
Search: Improved query parser for additional security
Search: Added uid:... search filter to find photos by uid
Search: keywords:... filter does not exclude stopwords anymore
Index: Original filenames can be extracted from Exiftool JSON
Index: More accurate and resilient handling of related files and photo stacks
Live Photos: HEIF is used to create primary JPEG instead of a MOV still image
Metadata: Reduced log level for missing Exif data from warn to info
Metadata: Increased size of projection and color profile fields to 40 characters
Backups: Improved help for config options and CLI commands
Help: Fixed reverse proxy documentation links
Config: Added Apple Video Toolbox hardware transcoding support for macOS
Config: Added /opt/photoprism to search path for asset and storage folders

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.

Sharing: Fixed album link redirect on shared domains
Import: More helpful warning when another import is already running
Docker: ARMv7 image for 32-bit processors and operating systems

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.

Security: Upgraded Go to v1.17.5, which includes HTTP/2 and networking fixes
People: Concurrent updates are no longer possible to prevent inconsistencies
Places: Additional logs to detect invalid GPS coordinates in metadata
SQLite: Reduced routine maintenance log levels and fixed migration warnings
Thumbnails: Apple Display P3 profile support for more accurate colors
Translations: Updated French

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 sponsor feature. We believe this is fair. A big thank you to all our sponsors and contributors!

CLI: Improved parameter and command descriptions
CLI: Reset command optionally also deletes files in the cache folder
Config: Improved docker-compose.yml examples

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.

CLI: photoprism migrations run --failed will re-run previously failed migrations

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 upgraded to Ubuntu 21.10, which ships with Darktable 3.6 among other updated dependencies.

UX: Redesigned splash screen based on theme colors
Places: Viewer loads faster and sorts photos by distance instead of date
Places: Less frequent estimates to reduce background activity
Places: Normalized names of states, oceans, and lakes
Places: Updated location data from OpenStreetMap
Places: State albums are grouped by country name
Folders: Path names are searched in addition to titles
People: Improved face detection performance
People: Fixed naming faces in non-primary files
People: Optimized matching of children's faces
RAW: Upgraded Darktable to 3.6.0
Metadata: Improved estimates and UTC time zone handling
Metadata: Altitude is indexed even if coordinates are missing
Auth: Usernames are not case-sensitive anymore
CLI: Added --force flag to photoprism optimize command
CLI: Improved parameter and command descriptions
Config: Improved docker-compose.yml examples
Translations: Added Bahasa Indonesia and Hungarian
Translations: Updated Polish and Italian

For our sponsors and contributors:

October 18, 2021¶

Build 211018-e200f322

UI: Updated Lavender theme
Places: Fixed maps initialization after reload in non-public mode
Search: Added live and raw:true filters as alternative to type:…
Search: Added faces:new alias for face:new
Config: Maximum background worker interval has been increased to 7 days
Security: Added Content-Security-Policy header to prevent framing attacks
Translations: Updated Russian and Slovak

For our sponsors and contributors:

UI: New Vanta dark theme ✨

October 10, 2021¶

Build 211010-83b4f783

Translations: Fixed German frontend typo
Translations: Updated all backend locales

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`

UX: Improved wording of search result notifications
UX: Fixed sidebar navigation on small screens
Users: Show name and email in sidebar navigation
Folders: Directory names listed in .ppignore are ignored
Config: Allows bypassing low memory suggestion
Docs: Updated about page
Translations: Updated all frontend locales

October 7, 2021¶

Build 211007-8f55d6f8

For our sponsors and contributors:

People: Recognized faces can be hidden on the overview page

October 2, 2021¶

Build 211002-bf015326

People: Enhanced UI / UX for renaming and merging faces
People: Improved face detection accuracy
Labels: Improved photo count accuracy
Covers: Thumbnails load and update faster
Search: Finds titles when query is too short for full-text index
Search: name:… filter ignores path and extension
Videos: Optional Intel GPU hardware transcoding support
Index: Automatic cleanup of orphaned file entries
Logs: Updated log messages for improved readability
Translations: Updated German and French
Docker: Simplified installation of TensorFlow with AVX / AVX2 support
Docker: Entrypoint script uses prefixed environment variables, UID and GID are deprecated

September 25, 2021¶

Build 210925-96168e4b

Recognizes faces so that specific people can be found
UX: Improved UI design, navigation, and wording
Search: Omit full-text index if query is too short
Search: Added keywords:…, subjects:…, and albums:… filters
Places: Internationalized maps incl RTL support
Labels: Added photo counts to overview page
Albums: Fixed share expiration date in form label
Calendar: Empty month albums are hidden
Viewer: Photos will be updated when search filters change
Index: Ignore Synology @eaDir folders
Import: Ignore dot files listed in .ppignore
Upload: Added more detailed error logs
Videos: Skip related images when downloading
Videos: Added .mp as known MP4 file extension
Videos: Default to UTC as metadata time zone
Exiftool: Enabled large file support
Metadata: Improved Exif parser with cycle detection
Metadata: Support for long projection type names like transverse-cylindrical
Config: Added RAW file extension blacklists for Darktable and RawTherapee
Config: Added disable options for image classification and facial recognition
Config: Added support for non-root site URLs
Config: Added content delivery network URL option
MariaDB: Set explicit table engine, charset, and collation
MariaDB: Added log message for old versions with broken table name resolution
Docker: Added HOME env for Darktable & RawTherapee
Docker: Single multi-arch image for AMD64, ARM64, and ARMv7

May 23, 2021¶

Build 210523-b1856b9d

May 20, 2021¶

Build 210520-4b32bac7

May 19, 2021¶

Build 210519-24b5c7e6

Metadata: Upgraded Exiftool to fix security issue

May 18, 2021¶

Build 210518-80981c25

Safari: Fixed PWA file download on iOS
Docker: Added config example for scheduled background tasks
Docker: Updated base image includes Darktable 3.4.1, RawTherapee 5.8, and FFmpeg 4.3.2
TensorFlow: Improved error handling
Translations: Updated French

May 5, 2021¶

Build 210505-d3e53a89

UI: Improved RTL (right-to-left language) alignment
RAW: Added config options to disable specific converters
Metadata: Preserve stopwords in existing keywords
Metadata: Allow single quotes in keywords
WebDAV: Keep favorite flag when uploading via PhotoSync
Translations: Updated Dutch and German

April 26, 2021¶

Build 210426-da6e948f

UI: Added Yellowstone theme for sponsors, unlocked Grayscale theme for everyone
Metadata: Support for XMP sidecar CreateDate and Keywords
Metadata: Merge keywords from different sources
Translations: Updated Hebrew

April 22, 2021¶

Build 210422-97e75b04

UX: Improved touch event accuracy
UX: Optimized rendering on small screens
UX: Fixed autocomplete in "add to album" dialog
HEIF: Prevent redundant sidecar JPEG files
Backup: Added command flags and usage docs
Translations: Added Danish and Kurdish

February 22, 2021¶

Build 210222-ac5a9d5e

UX: Autofocus for input fields and confirm on enter
Restore: Find YAML album backups in originals folder
Metadata: Improved location labels and moments
Thumbnails: Fixed auto-rotation for HEIF, TIFF, and PNG images
Translations: Added Norwegian (Bokmål)

February 17, 2021¶

Build 210217-49039368

Videos: Optimized transcoding parameters
Videos: Use AAC audio for MP4 transcoding
Metadata: Default to landscape orientation if data is invalid
Translations: Updated Brazilian Portuguese

February 16, 2021¶

Build 210216-4939e36a

UX: Automatically hide scrollbar in photo viewer and Places
Delete: Permanently remove all related sidecar files
Videos: Added transcoding config options
Videos: Added batch transcoding via convert command
Metadata: Remove estimate when setting a new country
Metadata: Workaround for Exif strings containing newlines

February 11, 2021¶

Build 210211-b9595dd4

February 8, 2021¶

Build 210208-9e10ba69

Upload: Adds duplicates to selected albums as well
Library: Show folder covers in Originals
Metadata: Automatically remove orphan countries, cameras, and lenses
Metadata: Improved Exif parser
Backup: Restore archive flag from YAML files
Docker: Improved entrypoint script

January 28, 2021¶

Build 210128-a82061e0

UX: Improved theme colors and icons
UX: Download all related media files using their current name by default
UX: Redirect already authenticated users from /login to /browse
Mobile: Prevent like on touch swipe
Translations: Updated German and French
Config: Reduced auto index & import safety delay defaults
Metadata: Improved photo titles, removed small words from title endings
Metadata: Improved date extraction from current and original file names
Metadata: Fallback to earliest file mod time in case there is no other date
Import: Index keywords from non-primary filenames as well
WebDAV: Improved service discovery
Purge: Hide missing files in edit dialog and set new primary if needed
Archive: Physically delete files after confirmation
Moments: Added delete button to context menu
Settings: Added Estimates and Delete feature flags
CLI: Added cleanup command to remove orphaned index entries and thumbnails

January 21, 2021¶

Build 210121-07e559df

January 20, 2021¶

Build 210120-e7cd5e9a

January 19, 2021¶

Build 210119-a5399f06

UX: Optimized user interface for iOS and tablets
UX: Improved theme colors
UX: Scroll position is restored when navigating back
Translations: Added Czech
Metadata: Estimate timezone and allow overwriting estimated locations
Settings: Fixed disabling logs

For our sponsors and contributors:

UX: Added two dark themes

January 11, 2021¶

Build 210111-cc05c430

UX: Disabled preloading in live photo player to reduce memory footprint
UX: Updated main navigation, find all media types via /browse
UX: Removed lag when selecting pictures
UX: Tweaked tile size breakpoints in Albums, Labels, and Search
UX: Added tooltips to navigation expand and minimize buttons
UX: Preload additional search results
UX: Removed image loading spinners for faster rendering
Thumbnails: Added cache control headers for improved performance
Album Covers: Cache will be flushed after updating private flags
Search: Improved performance of photos query
PWA: Added service worker so that app can be installed more easily
PWA: Enabled auto-rotate so that photos may be viewed in landscape mode
Frontend: Removed unused dependencies and reduced build size
Translations: Updated Russian, French, Simplified Chinese, and German
Index: Automatically create JPEGs for related media files as well
Import: Improved error handling when the file system becomes unavailable
Config: Updated docker-compose.yml examples
Config: Added optional gzip compression for built-in web server
Config: Limit number of indexing workers to half the number of physical cores by default to avoid high load on hyper-threading capable CPUs

January 4, 2021¶

Build 210104-7f9e806a

Config: Added auto index & import defaults to Dockerfiles
Import: Extract metadata with ExifTool before moving
Import: Automatically create folder albums
Help: Updated WebSocket page
UX: Added UI.Zoom setting to re-enable page zoom
UI: Updated default theme
Translations: Added Hebrew & Japanese, updated Brazilian Portuguese
Albums & Cards View: Reduced tile size on large screens
WebDAV: Less verbose logging

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 most recent image and restart, or set up a service like Watchtower to get automatic updates.