Starstruk Logo MarkStarstruk

v0.6.0-beta

gtsteffaniak/filebrowserv0.6.0-betaMar 9, 2025by gtsteffaniak

AI Summary

This is a significant beta release (v0.6.0-beta) that introduces multiple sources support, removes the deprecated `server.root` parameter in favor of `server.sources`, and simplifies user permissions to four groups. Users are strongly advised to backup their database before upgrading.

Key Highlights

  • Multiple sources support with independent listing views and URL prefixing (/files/<sourcename>/path/to/file)
  • User permissions simplified to four groups: admin, modify, share, api (removed: create, rename, delete, download)
  • `server.root` completely removed in favor of `server.sources` configuration
  • `FILEBROWSER_CONFIG` environment variable now respected when no CLI config provided
  • User rules and commands removed (commands were never enabled, rules coming back in different form)

Breaking Changes

  • `server.root` is completely removed - use `server.sources` instead
  • User permissions simplified - removed create, rename, delete, download permission options
  • `scope` is deprecated (still supported for default source only)
  • User rules and commands removed entirely
  • GET API keys now uses `name` query parameter instead of `key`
  • Downloads no longer open new browser windows

New Features

  • Multiple sources support with independent listing views and source switching
  • Per-source search with selection toggle (searches current scope or source root)
  • `FILEBROWSER_CONFIG` environment variable support
  • Swagger documentation updated with auth API help including API token guidance
  • Fixed conflict resolution issue
  • Fixed share delete issue
  • Multiple user creation page bugfixes

Full Release Notes

> [!WARNING]
> This release includes several config changes that could cause issues. Please backup your database file before upgrading.

This release has several changes that should work without issues... however, still backup your database file first and proceed with caution. User permissions and source config changes have been updated -- and the `server.root` parameter is no longer used.

This is a significant step towards a stable release. There shouldn't be any major breaking config changes after this.

 **New Features**:
  - multiple sources support https://github.com/gtsteffaniak/filebrowser/issues/360
    - listing view keeps them independant, you switch between the two and the url address will have a prefix `/files/<sourcename>/path/to/file` when there is more than 1 source.
    - search also happens independantly, with a selection toggle per source. searching current source searches the current scope in the listing view, if you toggle to an alternative source it will search from the source root.
    - copy/moving is currently only supported within the same source -- that will come in a future release.
  - `FILEBROWSER_CONFIG` environment variable is respected if no CLI config parameter is provided. https://github.com/gtsteffaniak/filebrowser/issues/413

 **Notes**:
  - downloads no longer open new window.
  - swagger updated with auth api help for things like api token.
    - GET api keys now uses `name` query instead of `key`. eg `GET /api/auth/tokens?name=apikeyname`
  - user permissions simplified to four permission groups (no config change required):
    - **removed**  : create, rename, delete, download
    - **remaining**: admin, modify, share, api
    - `scope` is deprecated, but still supported, applies to default source. if using multiple sources, set `defaultUserScope` at the [source config](https://github.com/gtsteffaniak/filebrowser/wiki/Configuration#default-source-configuration) instead.
  - **removed** user rules and commands.
    - commands feature has never been enabled so just removing the references.
    - rules will come back in a different form (not applied to the user).
  - `server.root` is completely removed in favor of `server.sources`

 **BugFixes**:
  - fix conflict resolution issue https://github.com/gtsteffaniak/filebrowser/issues/384
  - many user creation page bugfixes.
  - fix share delete issue https://github.com/gtsteffaniak/filebrowser/issues/408
 
<img width="294" alt="image" src="https://github.com/user-attachments/assets/669bca75-98d4-47c1-838b-1ffee2967d7d" />

**Full Changelog**: https://github.com/gtsteffaniak/filebrowser/compare/v0.5.4-beta...v0.6.0-beta