Breaking changes
- The DB gets rebuilt on the first start, so the first indexing takes a while. Users are kept now; older updates (e.g. to 3.5.2) deleted them, then log in with
admin/admin. #1399 - Docker: the images run on Node 26 and there is no
linux/arm/v7image anymore. 32-bit Raspberry Pi OS users need a 64-bit OS (or stay on 3.5.2). #1284 - Extensions: the backend moved to Express 5 and TypeORM 1. Extension REST paths need the Express 5 path syntax (no regex params,
:id?becomes{:id}, wildcards need a name like*path); a path that doesn't parse is logged and skipped.getCacheForDirectorygets aDataSourceinstead of aConnection, andinvalidateDirectoryCachegets aDirectoryPathDTO. Update to the latest extension kit (now on npm, #1319). #1291 #1290 - Uploads only go into an existing folder whose content the user can see; the uploader no longer creates folders. #1385
Indexing.excludeFolderList:*and?are now wildcards. Existing entries keep working, except a folder name that contains a literal*or?. #192
Main new features
- Folder sharing is back: share a folder with a link, optionally with a password and an expiry date #1133 #1076
- Sharing: a "Prevent downloading" switch. Guests of such a link get no zip or lightbox download, and saving with right click or dragging is blocked (it can't be fully prevented). #1158
- Huge folders scroll smoothly, also on phones: the grid gets a touch scroll handle and never hits the browser's page height limit. #1394 #1395 #1396 #1397
- Better installed app (PWA) on phones: proper icons, the page stays clear of the notch, the theme colour follows light / dark mode, and the share dialog can open the phone's share sheet. #1390
- Apple Live Photos support (
Media.LivePhoto.enabled) by @bexelbie in #1139 (#609) - Hide hidden (dot) files and folders, plus a file name exclude list with
*and?(Indexing.excludeFilenameList) #803 #929, by @cat101 in #1141 - Glob wildcards in
Indexing.excludeFolderListby @cycsmail in #1168 (#192) - Date label next to the scrollbar while scrolling a date-sorted grid by @officialasishkumar in #1369 (#1209)
- Sorting and grouping by directory by @Berschi in #1198
- Per-user allow / block directory lists (
Users.allowDirectoryList,Users.blockDirectoryList) #1147 - OIDC: role of auto-created users, and a strict security mode for providers where not everyone is trusted
- Accent-insensitive search on SQLite (
Database.sqlite.accentInsensitiveSearch) - Upload limits:
Upload.maxFileSizeMBandUpload.blockedExtensions - About page (in the menu, for everyone): what PiGallery2 is, links to the docs and the release notes, and how to support it. Admins also see the build details there, ready to copy into a bug report.
- Admins get a "What's new" popup with these notes once after every update.
- Let normal users create and delete albums (
Album.writeAccessMinRole, default: Admin; needs a server restart) by @dasmaetthes in #1400 (#557). Albums are visible to everyone who can list them, and both album rights are at least User. The server now also checksAlbum.readAccessMinRolewhen listing albums (before it only hid the tab). - Nobody can give a role above their own or change a user above it: an Admin can't make a user Developer, set a role setting to Developer, or change, delete or set the password of a Developer. Changing
Faces.writeAccessMinRole,Faces.readAccessMinRoleorUpload.minimumRoleis marked as needing a server restart (it always needed one).
Under the hood
This is the bulk of this release: lots of bug fixes, security fixes and a full tech stack upgrade.
- Security fixes: deleting or changing a user or a sharing now ends its open sessions (and
Server.sessionTimeoutis enforced on the server), uploads check the folder rights of the user, nobody can give a role above their own, a path traversal in deleting extensions is fixed, and all CodeQL alerts are resolved #1212 #1385 #557 #1300 #1302 - Angular 19 → 22: zoneless, signals and
OnPusheverywhere, esbuild, lazy-loaded routes, fewer dependencies (Hammer.js, ngx-toastr,@angular/animationsreplaced) #1219 - Backend on Node 26, Express 5, TypeORM 1, strict TypeScript and type-aware linting #1279
- End-to-end tests for all main user journeys, and the bugs they found are fixed #1254 #1344
Further changes
- Closing the lightbox goes back in the browser history, so the Back button no longer opens the photo again #470
- Login: after logging in you land on the link you opened, and the app tells you when your session has ended #1306
- Clear empty states and error pages: loading spinners, "Page not found", folder not found, and one page for an invalid or expired sharing link #1344 #1307
- The zip of a folder is named after the folder, and downloading a deleted file says so #1311
- Uploader: names the rejected files, offers a retry, and uploads go to the temp folder instead of RAM #1314
- The
Gallery.enableOnScrollRenderingsetting is removed: the grid always renders only what is near the screen. - Lightbox hides the mouse cursor with the controls by @cycsmail in #1175 (#736)
- Search: the phone keyboard's Enter key starts the search by @patxixi in #1214
- Extensions:
contains/!containsin media buttonmetadataFilter, and in-place refresh after a metadata change by @patxixi in #1200 - Extensions: manual-install listings by @v-marinkov in #1182
- Grid: photos in grouped view have the same height when groups share a row #1208
- Random sort is no longer biased (Fisher-Yates) by @infinitejones in #1131
- Docker: the release images are rebuilt every week on fresh base images, so OS and Node security fixes arrive without a new release (same tags, e.g.
latest; Watchtower picks them up). The release zip now ships apackage-lock.json, so every build installs the npm versions that were tested. - Only admins see the app version: it is no longer in the browser console or the page source of every visitor.
- Guests of a sharing link no longer get search autocomplete, and notifications are shown only to users with the User role or above. #1204
- The sponsor links moved from the bottom of the settings page to the about page.
- The server log tells when the DB got rebuilt, when the default
admin/adminuser was created, and when a login failed because the user does not exist. #1399 - The example nginx configs (Docker and Nginx Proxy Manager) rate limit the login and the API, only allow TLS 1.2+, and forward the client IP (see
Server.trustProxy). If you copied an older one, compare it with the new one: the login limit could be bypassed by writing the URL in upper case. #1302
Bug fixes
- Photos lost all metadata when their XMP segment started right before 64 KiB by @PhilippMundhenk in #1270 (#1269)
- Uploaded files with accented names got mangled names #1263
- Search keywords (
and,or) are case-insensitive by @cycsmail in #1177 (#1090) - Wrong share link with a different base URL by @galagithub in #1170
- Lightbox left the page scroll locked when it closed abnormally by @patxixi in #1210
- Search: names with double spaces were not found by a search with single spaces #1309
- Debian Docker image copied the wrong build folder by @moaz-ahmed in #1127
- Random link creator URLs returned errors #1140
- Can't create albums based on date #1152
- Search: negated ranges (e.g.
rating!:1..2,rating!=2) found nothing, date searches (e.g.date=2020-05-05,date<=2020-05-05) missed the photos of their last day, and decimal resolutions and distances (e.g.resolution>=0.5,1.5-km-from:Budapest) were searched as plain text. The query builder showed an empty relation (=/!=) for non-text searches. - Saving a search link without a query broke routing #1176
- Albums with an invalid search query are not saved; a broken entry of a
.saved_searches.pg2confis skipped with a warning to the admins instead of stopping the indexing. - Memory leak during indexing #1070
vips_colourspaceerror #1122,creationDatenull error #1126, numeric tags shown twice #1103
New Contributors
- @moaz-ahmed made their first contribution in #1127
- @infinitejones made their first contribution in #1131
- @cat101 made their first contribution in #1141
- @bexelbie made their first contribution in #1139
- @v-marinkov made their first contribution in #1182
- @cycsmail made their first contribution in #1177
- @galagithub made their first contribution in #1170
- @patxixi made their first contribution in #1210
- @hamidzr made their first contribution in #1276
- @officialasishkumar made their first contribution in #1369
- @PhilippMundhenk made their first contribution in #1270
- @dasmaetthes made their first contribution in #1400
Full Changelog: 3.5.2...3.8.0