diff --git a/docs/snippets/quickstart-install.md b/docs/snippets/quickstart-install.md index a9125e5894..5e8722a30b 100644 --- a/docs/snippets/quickstart-install.md +++ b/docs/snippets/quickstart-install.md @@ -87,13 +87,38 @@ To get a local deployment of Knative, run the `quickstart` plugin: ```bash netstat -tnlp | grep 80 ``` - 1. After the plugin is finished, verify you have a cluster called `knative`: ```bash kind get clusters ``` + + + ### 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: