We’re pleased to announce the release of Fess 15.9.0.
This release makes the static theme the default search UI and removes the JSP search UI, adds search analytics, document reports and CSV export, and brings engine-side rank fusion and RAG chat improvements. Fess is also slimmer and more modular: the embedded OpenSearch, the bundled Playwright runtime, the Groovy engine and the storage and SSO integrations are no longer part of the core distribution. The search engine baseline moves to OpenSearch 3.9.
Highlights
- Static Theme as the Default UI — The Bootstrap static theme is now the default and reaches parity with the former JSP search pages, including server-side support for the SPA, facet selections kept in the URL, accessibility fixes and translations in all supported languages. Themes can be installed from the admin theme page by choosing a theme and version from dropdowns, from a Maven repository, or from the command line with fess-setup.
- Search Log Analytics & Document Report — The search log screen becomes an analytics dashboard with drill-down into zero-hit searches, usage by role and group, RAG chat usage, and CSV download of logs and reports. A new admin report lists duplicate and dormant documents.
- Search Results Export, Search History & User Tags — Users can export search results as CSV or JSON, re-run their recent searches, and tag documents. Tags are kept per user and limited to what the caller can see.
- Engine-Side Rank Fusion — The search engine can fuse the searchers into one request, with a configurable pagination depth, bounded waits for searchers that do not answer, and safe fallbacks to Fess-side fusion. Highlighting and related-query handling are kept intact.
- RAG Chat — Chat can answer questions about a single document, restrict itself to permitted roles and labels, respond in a configurable language, and refine its search query in a bounded loop. Usage is recorded for analytics.
- OCR & File Owner Search — New settings enable OCR for images and scanned PDFs during crawling, and the file owner and last modifier are now indexed and searchable.
- Command-Line Plugin and Theme Management — bin/fess-setup installs and removes plugins and themes, checks and upgrades plugins, pins a version per plugin, and installs OpenSearch. It ships in the rpm and deb as well as the ZIP.
- JavaScript Script Engine — Fess ships a JavaScript engine and uses it for the default jobs. Each document boost rule can choose its script engine.
- OpenSearch 3.9 Support — Fess is based on OpenSearch 3.9.0 and reports a backend older than OpenSearch 3 at startup. Faiss is now usable for vector search because the official OpenSearch distribution is used.
Breaking Changes — please read before upgrading
- JSP search UI removed — The static theme is the default; JSP themes, the JSP theme plugin type and the admin page design editor no longer exist.
- OpenSearch is no longer embedded — Install a separate OpenSearch server with bin/fess-setup install opensearch.
- JavaScript replaces Groovy as the default script engine — An unset script type is still treated as Groovy, but the Groovy plugin is no longer bundled. Install it with bin/fess-setup install plugin fess-script-groovy if your crawl configurations, boost rules or path mappings use it.
- S3/GCS storage clients and the four SSO authenticators moved to plugins — fess-storage-s3, fess-storage-gcs, fess-sso-saml, fess-sso-spnego, fess-sso-entraid and fess-sso-oidc. The storage: crawl protocol is gone; use s3:.
- api.access.token.required removed.
- Node.js is installed on demand instead of bundling Playwright’s copies, and the Playwright crawler ships as a plugin.
- Jackson 3 replaces Jackson 2.
- Japanese kana variants and dashes written as long vowel marks are folded further — If you index Japanese content, reindex so that documents already indexed use the new normalization.
Beyond the highlights, this release includes many fixes to search, crawling, authentication, the admin API and packaging (secret masking in logs and diagnostics, robots.txt Crawl-delay support, deb/rpm upgrade handling, 400/503 responses instead of 500 for bad requests, and more). See the release notes for the full list.
Release Notes: Release Fess 15.9.0 · codelibs/fess · GitHub
Docker Image: Package fess · GitHub
Documentation: https://fess.codelibs.org/
Community Forum: https://discuss.codelibs.org/
We recommend upgrading to Fess 15.9.0 for the new default static theme, search analytics and reporting, rank fusion and RAG chat improvements, and the many correctness and security fixes. Review the breaking changes above before upgrading an existing installation.
Thank you for using Fess!