The Federated Catalogue is an Eclipse XFSC service that makes assets — metadata descriptions of Providers, their Service Offerings, and Resources — available to Consumers. It supports verifiable-credential-based onboarding and pluggable trust-framework validation (Gaia-X Loire and standard JWT-VC formats). The service's role within the Gaia-X / XFSC ecosystem (system scope and context, building-block view) is described in the Architecture Document.
This project originated as the Reference Implementation of Gaia-X Federation Services Lot 5 — Federated Catalogue / Core Catalogue Features.
The supported way to build and run the Federated Catalogue locally is via the bundled Docker Compose stack: Steps to build FC.
The Keycloak realm name is configurable via the KEYCLOAK_REALM env var (default
federated-catalogue-realm). Existing deployments with a pre-existing gaia-x realm keep working by setting
KEYCLOAK_REALM=gaia-x. See Keycloak Realm Configuration
in the operator guide for details.
Walkthrough guide and scenario demos for new users live under examples/: how to ingest assets,
query the graph, and exercise admin-UI behaviour switches. The walkthroughs are curl-based and tool-agnostic. Prefer a
GUI? Import openapi/fc_openapi.yaml into your favourite OpenAPI client (Bruno, Insomnia,
Postman, …) for a per-endpoint workspace that stays in sync with the spec.
| Topic | Location |
|---|---|
| Architecture, requirements, deployment, ADRs (canonical) | Architecture Document |
| API reference | docs/api-docs.md |
| Operator guide (trust framework, Loire, credential formats) | docs/operator-guide.md |
| CI / CD workflows | docs/ci-cd.md |
| Operator notes (non-canonical) | Wiki |
| Issues & support | GitHub Issues |
| Releases | GitHub Releases |
The catalogue accepts Gaia-X Loire (VC 2.0 JWT) and standard JWT-VC; see the Operator Guide for the full matrix and the asset/credential terminology note.
Contributions are welcome. Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a pull request. As an Eclipse Foundation project, contributors must sign the Eclipse Contributor Agreement (ECA).
Project page: projects.eclipse.org/projects/technology.xfsc. For technical questions and bug reports, open an issue. The full list of contributors is maintained in CONTRIBUTORS.md and the GitHub contributor graph.
Apache License 2.0 — see LICENSE.