From 9af0951b8fca639784ade235a2e38f1b06754256 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ramiro=20Bl=C3=A1zquez?= Date: Wed, 11 Feb 2026 13:03:44 +0100 Subject: [PATCH 1/3] Update kind docs --- docs/snippets/quickstart-install.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/snippets/quickstart-install.md b/docs/snippets/quickstart-install.md index a9125e5894..4d76d3078a 100644 --- a/docs/snippets/quickstart-install.md +++ b/docs/snippets/quickstart-install.md @@ -88,6 +88,9 @@ To get a local deployment of Knative, run the `quickstart` plugin: netstat -tnlp | grep 80 ``` + Troubleshooting: Kind requestthat the client and server version match. To check that, run `$ kubectl version`. If Client Version and Server Version don't match check this [kind Known issues](https://kind.sigs.k8s.io/docs/user/known-issues/) and run `$ kn-quickstart kind --kubernetes-version X.YY.0` with the right version. + + 1. After the plugin is finished, verify you have a cluster called `knative`: ```bash From 0d954db09ab6cebb07aa3525b2099b284cd6f9b6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ramiro=20Bl=C3=A1zquez?= Date: Wed, 11 Feb 2026 13:09:25 +0100 Subject: [PATCH 2/3] Enhance troubleshooting for Kubernetes version mismatch Added troubleshooting section for Kubernetes version mismatch, including steps to check versions and recreate the cluster with a matching version. --- docs/snippets/quickstart-install.md | 31 +++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/docs/snippets/quickstart-install.md b/docs/snippets/quickstart-install.md index 4d76d3078a..969d1e4e91 100644 --- a/docs/snippets/quickstart-install.md +++ b/docs/snippets/quickstart-install.md @@ -87,16 +87,39 @@ To get a local deployment of Knative, run the `quickstart` plugin: ```bash netstat -tnlp | grep 80 ``` - - Troubleshooting: Kind requestthat the client and server version match. To check that, run `$ kubectl version`. If Client Version and Server Version don't match check this [kind Known issues](https://kind.sigs.k8s.io/docs/user/known-issues/) and run `$ kn-quickstart kind --kubernetes-version X.YY.0` with the right version. - - 1. After the plugin is finished, verify you have a cluster called `knative`: ```bash kind get clusters ``` + Here is the polished Markdown, ready to copy and paste directly into a GitHub issue or PR description: + + + ### Troubleshooting: Kubernetes Version Mismatch + + If the installation times out or pods fail to start, your Kind cluster (Server) version might be incompatible with your local `kubectl` (Client) version. + + 1. Check your current versions: + ```bash + kubectl version + + ``` + + 2. If the **Server Version** is significantly older than your **Client Version** (or you see a version skew warning), you should recreate the cluster using a matching version: + ```bash + # Replace 1.XX.Y with your Client Version (e.g., 1.35.0) + kn-quickstart kind --kubernetes-version 1.XX.Y + + ``` + + + For more details on version compatibility, see the [Kind Known Issues](https://kind.sigs.k8s.io/docs/user/known-issues/). + + + + + === "Using minikube" 1. Install Knative and Kubernetes in a [minikube](https://minikube.sigs.k8s.io/docs/start/) instance by running: From 1d7cb7157901e8880cf1b411ee139ee79e2a03ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ramiro=20Bl=C3=A1zquez?= Date: Fri, 20 Feb 2026 09:56:47 +0100 Subject: [PATCH 3/3] Update docs/snippets/quickstart-install.md --- docs/snippets/quickstart-install.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/snippets/quickstart-install.md b/docs/snippets/quickstart-install.md index 969d1e4e91..5e8722a30b 100644 --- a/docs/snippets/quickstart-install.md +++ b/docs/snippets/quickstart-install.md @@ -93,7 +93,6 @@ To get a local deployment of Knative, run the `quickstart` plugin: kind get clusters ``` - Here is the polished Markdown, ready to copy and paste directly into a GitHub issue or PR description: ### Troubleshooting: Kubernetes Version Mismatch