# Stackable Hub

> Public information about the Stackable Data Platform (SDP), releases, components, and operational details for users running SDP and the tooling that integrates with it.

The hub is fully public and read-only. We expose a JSON API under `/api/v1/` for programmatic consumption (MCP servers, CI jobs, scripts). The API is CORS-enabled and requires no authentication.

## Pages

- [Home](https://hub.stackable.tech/): Overview of what the hub exposes.
- [Releases](https://hub.stackable.tech/releases): Shipped SDP releases and explicitly public upcoming releases, with provisional plans kept separate.
- [Components](https://hub.stackable.tech/components): All bundled SDP product components, each with a version timeline across shipped and upcoming releases.
- [CRDs](https://hub.stackable.tech/crds): Browse the operator CustomResourceDefinitions installed by SDP, with schemas, API versions and roles shown per SDP release. Individual CRDs live at /crds/<group>/<apiVersion>/<kind> (e.g. /crds/airflow.stackable.tech/v1alpha2/airflowcluster).
- [API preview](https://hub.stackable.tech/api): Human-friendly view of the JSON API catalogue.
- [llms.txt preview](https://hub.stackable.tech/llms): Human-friendly view of this document.

## API

- [GET /api/v1](https://hub.stackable.tech/api/v1): API discovery, catalogue of all available endpoints in JSON.
- [GET /api/v1/releases](https://hub.stackable.tech/api/v1/releases): JSON with a released-only `releases` array and a separate `upcomingReleases` array. Upcoming entries include `releaseDate: null`, `upcomingType` and `plannedReleaseDate`.
- [GET /api/v1/releases/latest](https://hub.stackable.tech/api/v1/releases/latest): Stable released-only JSON for the most recent shipped release. Fields: `version`, `releaseDate`, `platforms` and `products`. Upcoming releases never change this result.
- GET /api/v1/releases/{version}: JSON for a single shipped or explicitly upcoming release. Fields: `version`, `status`, nullable `releaseDate`, `upcomingType`, `plannedReleaseDate`, `platforms` (supported or planned Kubernetes/OpenShift versions), and `products` (each bundled or planned component with its `id` and `slug` (see /api/v1/components/{slug}), name, version lines and LTS/preview/deprecated status).
- [GET /api/v1/components](https://hub.stackable.tech/api/v1/components): JSON list of bundled product components. Fields: `id`, `slug`, `name`, `tile`, `currentLts`, `releaseCount`.
- GET /api/v1/components/{slug}: JSON for a single component. Fields: `id`, `slug`, `name`, `homepageUrl`, `currentLts`, `releaseCount`, released-only `releases`, and separate `upcomingReleases`. Upcoming entries include `upcomingType`, `plannedReleaseDate`, and provisional component versions. `currentLts` and `releaseCount` remain shipped-only.
- [GET /api/v1/crds](https://hub.stackable.tech/api/v1/crds): JSON list of CRDs for a public SDP release (?release=), optionally narrowed to one operator (?operator=<repo slug>, e.g. airflow-operator). Fields: `release` and `crds` (each `kind`, `group`, `apiVersions`, `activeApiVersion`, `roleCount`, `span`). An explicit `?release=` selects any release, including an upcoming one; a missing or invalid value defaults to the current shipped release when its CRD data is available, otherwise to the most recently shipped release with available CRD data. The selectable releases are listed at /api/v1/releases; `?release=dev` (main-branch data) is also accepted, and not every listed release has CRD data. Address a single CRD with its `group`, `activeApiVersion` and `kind`, lowercased.
- GET /api/v1/crds/{group}/{apiVersion}/{kind}: hub metadata for one CRD, resolved to a shipped, explicitly upcoming or dev SDP state (?release=). A kind alone is not a stable identifier (two operators may ship the same kind under different groups), so the group and apiVersion are part of the address. An apiVersion the CRD does not serve is a 404, never a fallback to a different schema. Fields: `kind`, `group`, `scope`, `apiVersions` (every served version), `activeApiVersion` (the one addressed in the path), `roles`, published-only `span`, `componentId` and `componentSlug` (the component the CRD belongs to; see /api/v1/components/{slug}), `release`, and `manifest` (links to the raw CRD). The schema is not duplicated here; fetch the manifest for it.
- GET /api/v1/crds/{group}/{apiVersion}/{kind}/manifest: the raw, verbatim CustomResourceDefinition (?release=, ?format=yaml|json, ?download). The complete, kubectl-apply-able manifest with the full schema for every served apiVersion. This is the schema source of truth.

## Documentation

The hub covers release, component and CRD data. Product documentation, guides, tutorials and reference live on the Stackable documentation site, which publishes its own llms.txt.

- [Stackable Documentation](https://docs.stackable.tech/llms.txt): Guides, tutorials and reference for the Stackable Data Platform and its operators, as a machine-readable index.

## Releases

### Current release

- [SDP 26.7](https://hub.stackable.tech/releases/26.7) (released 2026-07-21)
  - Platforms: Kubernetes 1.31 - 1.36, OpenShift 4.18 - 4.22
  - Components: Apache Airflow 3.0.6 (lts)/3.2.2/3.1.6 (deprecated)/2.9.3 (deprecated); Apache Druid 37.0.0 (lts)/35.0.1 (deprecated)/30.0.1 (deprecated); Apache Hadoop HDFS 3.4.3 (lts)/3.5.0/3.4.2 (deprecated); Apache HBase 2.6.6 (lts)/2.6.4; Apache Hive 4.2.0 (lts)/4.0.1 (deprecated)/4.0.0 (deprecated)/3.1.3 (deprecated); Apache Kafka 3.9.2 (lts)/4.2.1 (experimental)/4.1.1 (experimental)/3.9.1 (deprecated); Apache NiFi 2.6.0 (lts)/2.9.0/2.7.2 (deprecated); Apache Omid 1.1.3; Apache Phoenix 5.3.1 (lts)/5.3.0 (deprecated); Apache Spark 4.1.2 (lts)/4.1.1 (deprecated)/3.5.8 (deprecated); Apache Superset 4.1.4 (lts)/6.1.0/6.0.0 (deprecated); Apache ZooKeeper 3.9.5 (lts)/3.9.4 (deprecated); Open Policy Agent 1.16.2/1.12.3 (deprecated); OpenSearch 3.1.0 (lts)/3.6.0/3.4.0 (deprecated); Trino 477 (lts)/481/479 (deprecated)

### Upcoming releases

These releases are public planning data. Their contents and dates may change before publication.

- No upcoming releases are public.

### Past releases

- [SDP 26.3](https://hub.stackable.tech/releases/26.3) (released 2026-03-16)
- [SDP 25.11](https://hub.stackable.tech/releases/25.11) (released 2025-11-07)
- [SDP 25.7](https://hub.stackable.tech/releases/25.7) (released 2025-07-25)
- [SDP 25.3](https://hub.stackable.tech/releases/25.3) (released 2025-03-27)
- [SDP 24.11](https://hub.stackable.tech/releases/24.11) (released 2024-11-27)
- [SDP 24.7](https://hub.stackable.tech/releases/24.7) (released 2024-07-24)
- [SDP 24.3](https://hub.stackable.tech/releases/24.3) (released 2024-03-20)
- [SDP 23.11](https://hub.stackable.tech/releases/23.11) (released 2023-11-30)
- [SDP 23.7](https://hub.stackable.tech/releases/23.7) (released 2023-07-25)
- [SDP 23.4](https://hub.stackable.tech/releases/23.4) (released 2023-04-21)
- [SDP 23.1](https://hub.stackable.tech/releases/23.1) (released 2023-01-26)
- [SDP 22.11](https://hub.stackable.tech/releases/22.11) (released 2022-11-14)
- [SDP 22.9](https://hub.stackable.tech/releases/22.9) (released 2022-09-09)
- [SDP 22.6](https://hub.stackable.tech/releases/22.6) (released 2022-06-30)