Summary

Fess is an open-source, self-hosted enterprise search server built on OpenSearch, designed to index and search diverse data sources. It targets organizations needing a powerful, customizable search solution for internal documents, websites, and cloud services, offering advanced features like AI/RAG and semantic search. The primary benefit is a robust, self-managed search infrastructure that integrates seamlessly with existing systems.

How It Works

Built upon OpenSearch, Fess provides a full-text search engine accessible via a browser-based administration UI and REST API, abstracting OpenSearch complexity. Its core relies on a built-in crawler ingesting content from web pages, file systems, and data stores (databases, cloud, SaaS). Fess supports numerous document formats and offers faceting, sorting, and multilingual analysis for efficient data retrieval.

Quick Start & Requirements

Installation is via direct download (ZIP, RPM, DEB) or Docker. The ZIP method involves unzipping and running ./bin/fess. Docker images are on ghcr.io with a Compose file available. Prerequisites include Java 21+ and OpenSearch (bundled in Docker). Documentation is at fess.codelibs.org.

Highlighted Details

• Comprehensive data source crawling: Supports web, file systems, and numerous data stores (Confluence, Jira, databases, cloud storage, Git).
• Advanced search features: Full-text search with faceting, sorting, suggestions, and role/permission-based filtering.
• Extensive authentication: Integrates with LDAP, OpenID Connect, SAML, SPNEGO, and Microsoft Entra ID for SSO.
• Multilingual capabilities: UI and text analysis for 20+ languages.
• Extensibility: Supports custom plugins for data store connectors, ingest, scripting, and theming.

Maintenance & Community

Active maintenance is indicated by community support via discuss.codelibs.org and GitHub Issues for bugs/features. Contributions are welcomed, with guidelines for pull requests and code formatting. The project leverages internal libraries and OpenSearch.

Licensing & Compatibility

Distributed under the permissive Apache License 2.0. This license allows commercial use, modification, and distribution, including integration within closed-source applications, without copyleft restrictions.

Limitations & Caveats

Requires Java 21+, potentially necessitating environment upgrades. While the description mentions AI/RAG and semantic search, detailed implementation specifics for these advanced features are not elaborated upon in the README's feature list.