These notes cover changes specific to PhotoPrism® Portal, the central server that authenticates users and manages multiple PhotoPrism instances as a cluster. Portal images are published as photoprism/portal; pull a specific build with its 1.YYMM.DD tag or use latest.
Build 1.2610.29 (October 29, 2026)
This release upgrades the Portal’s database layer to GORM v2, lets apps and remote MCP clients sign in via OAuth, and adds a revoke-group command for removing group grants from cluster instances. New usernames must now consist of standard ASCII characters.
Upgrade Notes
- We recommend creating a database backup before upgrading. Due to schema migrations, the first start with an existing database may take longer than usual.
- Users who administer CE or Plus instances through the Portal need an explicit
admingrant for those instances.
What’s new?
- Auth: Added OAuth support for connecting apps and remote MCP clients
- Auth: Added connected apps to the account settings
- Users: Added an MCP switch to the account dialogs and enabled MCP for users and viewers
- Cluster: Added
cluster nodes revoke-groupto remove group grants from an instance - Cluster: Group grants now match sign-in groups without regard to case and accept IDs of up to 255 characters
- Users: New usernames must only consist of standard ASCII characters
- LDAP: Role changes at sign-in are now recorded in the audit log
- CLI: Added a
databasecommand group withbackup,restore, andtransfersubcommands - Database: Upgraded GORM database library from v1.9.16 to v1.31.2 by @keif888
- Security: Upgraded Go from v1.27.1 to v1.27.3 (11 CVE fixes)
Build 1.2610.07 (October 7, 2026)
This release upgrades the user interface to Vuetify 4, adds automatic HTTPS certificates from Let’s Encrypt, and forwards more client details to the instances behind the Portal. The users and audit commands that remove or reset data can now be confirmed with --yes, so they can run in scripts.
Upgrade Notes
- The default value of
PHOTOPRISM_TRUSTED_PROXYnow also includes the loopback addresses127.0.0.0/8and::1, so a reverse proxy running on the same host is trusted without additional configuration. Clusters that set the option explicitly are not affected.
What’s new?
- UX: Upgraded the user interface from Vuetify v3.12 to v4.2
- Server: Added support for Let’s Encrypt AutoTLS via TLS-ALPN-01
- Proxy: Improved forwarding of the client address, protocol, and origin host to instances
- Cluster: Added support for several comma-separated CIDR ranges in
cluster-cidr - Auth: Added a system log warning when an instance does not trust the Portal as a proxy
- Audit: Improved log, login, and user search to match terms literally
- CLI: Added
--yestousers rm,users reset, andaudit resetso they can run in a script - CLI: Added
--restoretousers addandusers modto restore a deleted account - CLI: Improved
users resetto also clear passwords, cluster grants, and OIDC tokens - Docker: Upgraded the base image to the current Ubuntu 26.04 package set
- Security: Upgraded the OIDC library to v3.51.12 and refreshed the Go module dependencies
Build 1.2609.15 (September 15, 2026)
This release lets you control how often the Portal rotates the keys it signs cluster tokens with, and rotate them on demand. Directory sign-in now resolves the same role every time for users who belong to more than one mapped group, and the cluster activity log records the client address as its own searchable column. It also refreshes the base image, the Go toolchain, and the module dependencies.
What’s new?
- Auth: Added scheduled and on-demand rotation of the keys the Portal signs cluster tokens with
- Auth: Improved how a role is selected when a directory user belongs to several mapped groups
- Cluster: Added the client address as a searchable column in the cluster activity log
- Cluster: Fixed live updates not appearing in the cluster management interface
- Docker: Upgraded the base image to the current Ubuntu 26.04 package set
- Security: Upgraded the Go toolchain and refreshed the Go module dependencies
Build 1.2608.17 (August 17, 2026)
This is a maintenance release. It refreshes the base image, the Go toolchain, and the module dependencies, and polishes the wording of the cluster node command output.
What’s new?
- CLI: Improved the wording of the cluster node update and key rotation messages
- Docker: Upgraded the base image to the current Ubuntu 26.04 package set
- Security: Upgraded the Go toolchain to 1.26.6 and refreshed the Go module dependencies
Build 1.2608.13 (August 13, 2026)
This release improves cluster sign-in with identity providers that emit large group claims and completes the localization of authentication messages. It also requires super-admin authority to create super-admin accounts, and refreshes the base image, Go modules, and frontend packages.
What’s new?
- Auth: Widened the OIDC
id_tokencolumn so sign-in works with group-heavy tokens - Auth: Improved login, session, and OIDC messages to appear in the current interface language
- Security: Hardened super-admin account creation to require super-admin authority
- Interface: Added touch app icon variants for use on iOS home screens
Build 1.2607.02 (July 2, 2026)
This release improves cluster account administration: session records now display the creation date in the admin interface, Portal admins can disable two-factor authentication for instance accounts, and the built-in super-admin controls are locked against accidental changes. It also updates the default database to MariaDB 12.3 (LTS).
What’s new?
- Auth: Fixed session timestamps so the admin UI shows the session creation date and empty login times are stored as
NULLunder strict SQL modes - Cluster: Added the option for Portal admins to disable two-factor authentication (2FA) for instance accounts
- Security: Hardened the built-in super-admin controls in the account edit dialog and strengthened form gating when adding accounts
- Database: Upgraded the default database to MariaDB 12.3 (LTS) instead of 11.8
Build 1.2606.27 (June 27, 2026)
This release lets you control how the Portal re-authenticates users against an upstream identity provider, so a rejected user or someone switching accounts can pick a different account instead of being silently signed back in. Authentication messages now also follow the interface language.
What’s new?
- Auth: Added a configurable OpenID Connect authorization prompt for re-authentication and account selection
- Auth: Improved login, session, and OIDC error messages to appear in the current interface language
The new PHOTOPRISM_OIDC_PROMPT option is set on the Portal (the Relying Party to your identity provider). Use select_account together with single sign-out so a user is shown the account chooser instead of being re-admitted with the previous session.
Build 1.2606.26 (June 26, 2026)
This release hardens cluster sign-in and account management.
What’s new?
- Auth: Hardened OpenID Connect sign-in by sending and validating a nonce on authorization requests
- Users: Added a safeguard that prevents a non-super-admin administrator from locking out the super admin
- Reliability: Fixed a frontend production-bundle regression that could break option lists
Build 1.2606.24 (June 24, 2026)
This release adds RP-initiated single sign-out, so signing out of the cluster also ends the upstream provider session instead of leaving it active for silent re-admission.
What’s new?
- Auth: Added RP-initiated OpenID Connect logout via
PHOTOPRISM_OIDC_LOGOUT - Auth: Hardened cluster sign-out to delegate to the Portal end-session endpoint so the chain reaches the upstream provider
- ACL: Improved CLI role and auth-provider help by generating it from the cluster role tables
Enabling single sign-out requires registering the post-logout redirect URI(s) on your identity-provider client, otherwise the provider rejects the logout. See the Config Options reference for details.