From e10505eac0ddc0c19ff2bf0d5cc8227d56c449a1 Mon Sep 17 00:00:00 2001
From: Jorge Arias <8829064+joariasl@users.noreply.github.com>
Date: Fri, 3 Oct 2025 14:26:54 -0300
Subject: [PATCH] Fix Kubernetes install docs to use OCI artifacts instead of
 deprecated helm chart (#5596)

---
 .../05-installation/20-helm-chart.md          | 21 ++++++++++++++++---
 .../05-installation/20-helm-chart.md          | 21 ++++++++++++++++---
 .../05-installation/20-helm-chart.md          | 21 ++++++++++++++++---
 3 files changed, 54 insertions(+), 9 deletions(-)

diff --git a/docs/versioned_docs/version-3.10/30-administration/05-installation/20-helm-chart.md b/docs/versioned_docs/version-3.10/30-administration/05-installation/20-helm-chart.md
index d421f8959..00f1c8b5d 100644
--- a/docs/versioned_docs/version-3.10/30-administration/05-installation/20-helm-chart.md
+++ b/docs/versioned_docs/version-3.10/30-administration/05-installation/20-helm-chart.md
@@ -3,11 +3,26 @@
 Woodpecker provides a [Helm chart](https://github.com/woodpecker-ci/helm) for Kubernetes environments:
 
 ```bash
-helm repo add woodpecker oci://ghcr.io/woodpecker-ci/helm
-helm install woodpecker woodpecker/woodpecker
+helm install woodpecker oci://ghcr.io/woodpecker-ci/helm/woodpecker
 ```
 
-## Metrics
+## Configuration
+
+To fetch all configurable options with detailed comments:
+
+```bash
+helm show values oci://ghcr.io/woodpecker-ci/helm/woodpecker > values.yaml
+```
+
+Install using custom values:
+
+```bash
+helm install woodpecker \
+  oci://ghcr.io/woodpecker-ci/helm/woodpecker \
+  -f values.yaml
+```
+
+### Metrics
 
 To enable metrics gathering, set the following in values.yml:
 
diff --git a/docs/versioned_docs/version-3.8/30-administration/05-installation/20-helm-chart.md b/docs/versioned_docs/version-3.8/30-administration/05-installation/20-helm-chart.md
index d421f8959..00f1c8b5d 100644
--- a/docs/versioned_docs/version-3.8/30-administration/05-installation/20-helm-chart.md
+++ b/docs/versioned_docs/version-3.8/30-administration/05-installation/20-helm-chart.md
@@ -3,11 +3,26 @@
 Woodpecker provides a [Helm chart](https://github.com/woodpecker-ci/helm) for Kubernetes environments:
 
 ```bash
-helm repo add woodpecker oci://ghcr.io/woodpecker-ci/helm
-helm install woodpecker woodpecker/woodpecker
+helm install woodpecker oci://ghcr.io/woodpecker-ci/helm/woodpecker
 ```
 
-## Metrics
+## Configuration
+
+To fetch all configurable options with detailed comments:
+
+```bash
+helm show values oci://ghcr.io/woodpecker-ci/helm/woodpecker > values.yaml
+```
+
+Install using custom values:
+
+```bash
+helm install woodpecker \
+  oci://ghcr.io/woodpecker-ci/helm/woodpecker \
+  -f values.yaml
+```
+
+### Metrics
 
 To enable metrics gathering, set the following in values.yml:
 
diff --git a/docs/versioned_docs/version-3.9/30-administration/05-installation/20-helm-chart.md b/docs/versioned_docs/version-3.9/30-administration/05-installation/20-helm-chart.md
index d421f8959..00f1c8b5d 100644
--- a/docs/versioned_docs/version-3.9/30-administration/05-installation/20-helm-chart.md
+++ b/docs/versioned_docs/version-3.9/30-administration/05-installation/20-helm-chart.md
@@ -3,11 +3,26 @@
 Woodpecker provides a [Helm chart](https://github.com/woodpecker-ci/helm) for Kubernetes environments:
 
 ```bash
-helm repo add woodpecker oci://ghcr.io/woodpecker-ci/helm
-helm install woodpecker woodpecker/woodpecker
+helm install woodpecker oci://ghcr.io/woodpecker-ci/helm/woodpecker
 ```
 
-## Metrics
+## Configuration
+
+To fetch all configurable options with detailed comments:
+
+```bash
+helm show values oci://ghcr.io/woodpecker-ci/helm/woodpecker > values.yaml
+```
+
+Install using custom values:
+
+```bash
+helm install woodpecker \
+  oci://ghcr.io/woodpecker-ci/helm/woodpecker \
+  -f values.yaml
+```
+
+### Metrics
 
 To enable metrics gathering, set the following in values.yml: