Compatibility
Version requirements and tested combinations.
Requirements
| Component | Minimum | Notes |
|---|---|---|
| Kubernetes | 1.24+ | Older versions may work but are untested. |
| Tekton Pipelines | v0.40+ | Needs CloudEvents emission (default-cloud-events-sink). |
| Helm | 3.8+ | OCI registry support is required for the chart. |
| Go (to build) | 1.26+ | Only relevant when building from source. |
Tested combinations
| Relay version | Kubernetes | Tekton Pipelines | Status |
|---|---|---|---|
| latest | 1.30–1.33 | v0.56–v0.65 | ✅ CI-tested |
| latest | 1.24–1.29 | v0.40–v0.55 | ⚠️ Expected to work, not in CI |
CloudEvents compatibility
The relay decodes the CloudEvent types emitted by Tekton Pipelines — see Event Types for the full list and how unknown types are handled. New Tekton releases occasionally add event types; if you see no decoder registered for event type in the logs after a Tekton upgrade, open an issue with the type.
Provider API versions
| Provider | API | Self-hosted support |
|---|---|---|
| GitHub | REST v3 (+ GraphQL for discussions) | GitHub Enterprise Server via api-base-url |
| GitLab | REST v4 | Self-managed via base_url |
| Gitea | REST v1 | Always self-hosted |
| Bitbucket | Cloud 2.0 / Server 1.0 | Server variant via variant: server |
| Azure DevOps | REST 7.x | Azure DevOps Server via api-base-url |
| SourceHut | GraphQL | Self-hosted via api-base-url |