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 220703-18473e4d

Updated backend and frontend translations

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