• English

      • Compatibility

      Updated: 2026-08-31.

      The following versions are the current priority support and test ranges. Prefer a maintained stable release for new deployments and run the smoke tests at the end after upgrades.

      Source and registries

      ComponentSupported rangeNotes
      GitHubGitHub.com; GHES 3.17 ~ 3.21Verify OAuth, webhooks, and repository reads
      Gitea1.20.x ~ 1.25.xPrefer the current stable release
      GitLabNot supported yetUse GitHub or Gitea
      Docker HubCurrent public API v2Consider rate limits and connectivity
      Harbor>= 2.0; priority tests on 2.10.x ~ 2.14.xPrefer a maintained release
      Generic OCI RegistryDistribution API V2; OCI Distribution 1.0 ~ 1.1Enter a full image reference when catalog listing is unavailable

      Runtime and build

      ComponentSupported rangeNotes
      Kubernetes / K3sKubernetes 1.34 ~ 1.36Evaluate K3s by its embedded Kubernetes version
      Metrics ServerA version compatible with the clusterAbsence affects live resource metrics only
      Gateway API1.0.0 ~ 1.6.xRequires CRDs and a compatible controller
      Traefik3.xEnable the Kubernetes Gateway Provider
      cert-manager>= 1.0Must also support the current Kubernetes version
      PostgreSQL14 ~ 1817 recommended; SQLite is unsupported
      Redis7.x ~ 8.xCluster and Sentinel are not currently supported
      BuildKitv0.20+ rootlessDefault and priority test target is v0.34.1-rootless

      Identity, notifications, and observability

      ComponentSupported rangeNotes
      OIDC ProviderOIDC Core 1.0 + Discovery 1.0issuer and callback URLs must be reachable and match
      Prometheus2.40+ or 3.xAPI can be scraped; complete metrics can also use OTLP
      Grafana9.x ~ 12.xiframe embedding requires Grafana configuration and authentication
      SMTPStandard SMTP / STARTTLSHandle credentials as Secrets
      Webhook notificationsHTTP / HTTPS endpointConfigure target authentication and rate limits explicitly

      Verify after upgrades

      1. Git Provider: complete OAuth, read repositories and branches, and create a webhook.
      2. Registry: search images, read tags, push a build, and pull it from a runtime cluster.
      3. Kubernetes: create a build Job and Deployment, then read status, logs, and terminal access.
      4. Gateway: confirm that Gateway and HTTPRoute become accepted and programmed.
      5. OIDC: complete a real sign-in and verify the callback URL.
      6. Observability: confirm that API, Worker, and Agent telemetry is queryable.

      Use each component's official support matrix and the current Luna DevOps Release notes when a more exact compatibility decision is required.