v1.2.0-stable

gtsteffaniak/filebrowserv1.2.0-stableFeb 23, 2026by gtsteffaniak

AI Summary

Major version update introducing SQLite-based indexing for reduced memory usage with persistence between restarts, new realtime file watcher tool, and enhanced sharing capabilities including opengraph support and customizable sidebar links.

Key Highlights

  • SQLite-based indexing with reduced memory usage and persistence between restarts
  • New realtime file watcher tool with low latency for users with realtime permissions
  • Chunked downloads to fix 524 errors on cloudflare, optionally enabled in settings
  • Resizable sidebar and improved listing/scrolling performance
  • Enhanced sharing with opengraph support, customizable sidebar links, and file picker for favicon/banner

Breaking Changes

  • Docker config location changed to /home/filebrowser/data/config.yaml unless FILEBROWSER_CONFIG env var is set
  • server.cacheDirCleanup defaults to false instead of true
  • Indexing rules streamlined - previous style deprecated but still functional
  • bulkDelete API replaces delete API for all UI actions
  • Download API uses repeated file query param instead of files with comma
  • Public upload api query param renamed from targetPath to path
  • Removed upload api behavior assuming paths ending in / are folders
  • /api/media/subtitles API endpoint changed

New Features

  • SQLite-based indexing with persistence between restarts
  • Realtime file watcher with low latency
  • Access control works with individual files
  • Conditionally hide symbolic links as indexing rule
  • Breadcrumbs act as a drop area
  • Search multiple sources at once
  • File uploads resume from bad internet connection
  • Chunked downloads - optionally enabled in settings
  • Size calculation defaults to size on disk style, configurable via useLogicalSize
  • Allow deleting selected duplicates from duplicate finder
  • Opengraph support for shared links
  • Customizable sidebar links for share settings
  • File picker for share favicon and banner icon
  • Allow disabling Login button for shares
  • Global disable onlyoffice editor via * file option
  • Resizable sidebar
  • OIDC Authentication button text via frontend.oidcLoginButtonText
  • Enhanced favicon processing with more formats and sizes
  • Media playback queue control from device lock screen and notification panel
  • Two-pass approach for directories with metadata listing load
  • Enhanced delete prompt
  • Improved thumbnail generation performance
  • Better text file content detection
  • URL encoding changes for API consistency
  • CTRL + B disables sticky sidebar forever
  • Share upload links with folder/file access and UX improvements
  • Improved image viewer with thumbnail placeholders
  • Share banner and icon auto-scaled to 1024x1024
  • Added Dutch nl.json for frontend i18n

Full Release Notes

## What's Changed

> [!WARNING]  
> Docker now uses the default config `/home/filebrowser/data/config.yaml` unless otherwise configured using `FILEBROWSER_CONFIG=/home/filebrowser/config.yaml` env var to set as previously default location. See [getting started docs](https://filebrowserquantum.com/en/docs/getting-started/docker/#basic-setup-with-docker-compose).

Also see the docs for [tools](https://filebrowserquantum.com/en/docs/tools/overview/) if you weren't aware of the features!

This is a major version update with many changes which could cause unexpected behavior. Upgrades should proceed with caution and report any undesirable behavior. See the changes over v1.1.3-stable below:

 **New Features**:
 - SQLite-based indexing
   - reduced memory usage, higher CPU and IO usage.
   - index persistence between restarts (requires [persistent cacheDir](https://filebrowserquantum.com/en/docs/configuration/server/#cachedir))
 - new tool - "realtime file watcher" low latency if user has realtime permissions (#917)
 - Access control works with individual files too
 - conditionally hide symbolic links as indexing rule config (#1540)
 - make breadcrumbs act as a drop area (#1785)
 - search multiple sources at once (#848)
 - file uploads resume from bad internet connection #1599
 - chunked downloads - optionally enabled in settings or userDefaults. fix for 524 errors on cloudflare #1502
 - made size calculation consistent: defaults to "size on disk" style to mimic "du -sh", and allows config `source.config.useLogicalSize: true` for 0 size folders and actual size file sizes. (#1266)
 - Feature: allow deleting selected duplicates from duplicate finder (#1659)
 - share changes:
   - opengraph support for shared links
   - Allow adding "share settings" option to customizable sidebar links (#1825)
   - file picker for share favicon and banner icon
   - Allow disabling "Login button" for shares (#1673)
 - Global disable onlyoffice editor via "*" file option to disable all files for a specific user. (#1533) 
 - Resizable sidebar (#1896)
 - OIDC Authentication: Change Button Text via `frontend.oidcLoginButtonText` (#1708)
 - improved favicon processing (#1899)
   - supports more formats
   - supports larger images
   - automatcially generates multiple favicon sizes on startup for non-svg images. Custom svg favicons need a companion *.png to exist broad compatibilty
 - Enhanced media playback: Ability to control the queue from your device's lock screen and notification panel - Will also show
   metadata of the current playing media if available (#1917)

 **Notes**:
 - `server.cacheDirCleanup` defaults to `false` instead of `true`. For docker, you would still need to mount a cacheDir volume to persist cache between restarts.
 - indexing rules have been streamlined, see [docs](https://filebrowserquantum.com/en/docs/advanced/source-configuration/conditional-rules/). The previous style is deprecated but still functional.
 - improved listing load times for directories with metadata -- a two-pass approach. First a fast load to get the listing items, then a second api request to include metadata.
 - Enhanced delete prompt
 - bulkDelete API added and replaces the delete API for all UI actions. See swagger docs for usage.
 - raw download and patch resource api simplified to a single source per request. See swagger docs for usage.
 - UserScope function re-organization, if you notice any user scope issues, please open a GitHub issue.
 - file upload resume from bad internet connection #1599
 - upgraded imaging package and improved thumbnail generation performance. (#1797) (#1850)
 - updated download api to use repeated `file` query param for path instead of `files` with comma. See swagger for details (#1881)
 - Better text file content detection (#1726)
 - More url encoding changes for API which should make things more consistent. Open issues if you see path/source not found errors.
 - adjustments to the startup behavior for sqlite index for reusing the previous database on startup
 - CTRL + B disables sticky sidebar forever (#1869)
 - Sharing a link for uploads - folder/file access and UX polishing (#1902)
 - improved listing view and scrolling performance
 - improved image viewer which will utilize recent thumbnails as a placeholder when loading the full image.
 - Small reorganization of "Share" settings to make the popup clear (#1826)
 - Removed upload api behavior to assume paths ending in "/" are folders, strictly uses isDir query param
 - renamed public upload api query param from `targetPath` to `path`. see swagger docs.
 - Changed `/api/media/subtitles` api endpoint to better support subtitles.
 - Correcting some errors in French language (#1947)
 - add Dutch `nl.json` for frontend i18n -- thanks @Stephan-P (#1957)
 - share banner and icon images automatically serve a scaled down 1024x1024

**Full Changelog**: https://github.com/gtsteffaniak/filebrowser/compare/v1.1.3-stable...v1.2.0-stable