rancher: [BUG] INSTALLATION FAILED: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.27.4

Rancher Server Setup

Rancher version: latest
Installation option (Docker install/Helm Chart): Helm Charts
- If Helm Chart, Kubernetes Cluster and version (RKE1, RKE2, k3s, EKS, etc): k8s, Client Version: v1.28.2 Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3, Server Version: v1.27.4
Proxy/Cert Details: cert-manager, I ran the following command to get the cert details but got an error that says this kubectl get secret sh.helm.release.v1.cert-manager.v1 -n cert-manager -o jsonpath='{.data.certificate}' | base64 --decode | openssl x509 -text Error is Could not read certificate from <stdin> Unable to load certificate

Information about the Cluster

Kubernetes version: Client Version: v1.28.2 Kustomize Version: v5.0.4-0.20230601165947-6ce0bf390ce3, Server Version: v1.27.4
Cluster Type (Local/Downstream): Local k8s
- If downstream, what type of cluster? (Custom/Imported or specify provider for Hosted/Infrastructure Provider):

User Information

What is the role of the user logged in? (Admin/Cluster Owner/Cluster Member/Project Owner/Project Member/Custom)
- If custom, define the set of permissions: I bought mini pc to start a homelab so i decided it’s time for me to learn kubernetes and I’ll install and setup everything on my homelab with kurbernets and also using rancher to manage everything while learning so I just install docker and kurbenetes on my ubuntu server and the problem started with installing rancher with helm

Describe the bug

It just ask me to downgrade my kubernetes version before installing rancher and I do not want to because I will be using the kubernetes for many other things on this server This is the error I get Error: INSTALLATION FAILED: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.27.4 To Reproduce

installed docker from official website
installed kubectl from official website
install helm from official website
helm install your-release-name rancher-latest/rancher
–namespace cattle-system
–set hostname=ndetacloud.sslip.io
–set replicas=1
–set bootstrapPassword=admin
–wait helm install rancher rancher-latest/rancher
–namespace cattle-system
–set hostname=192.168.49.2.sslip.io
–set replicas=1
–set ‘bootstrapPassword=$8!zD#2vQy9LsP@1’ I used the above commands still the same error mentioned above Result

Expected Result

I just wanted a simple rancher ui to start learning Screenshots

Additional context

About this issue

Original URL
State: open
Created 9 months ago
Reactions: 4
Comments: 31

Most upvoted comments

Error: INSTALLATION FAILED: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.28.3

Add --version 2.5.9 solved my issue.

+10

leqnam on Nov 28, 2023

@Ndeta100 can you try to downgrade your k8s version to 1.26?

Downgrading does work, but if that will be required on an ongoing basis, maybe it should be noted in docs here or here or in both places along with the downgrade procedure for K3S (or at least a link to the procedure).

Since K3S and Rancher are closely related, many will assume that latest Rancher should be deployable on latest K3S which is not the case (at least not following the official documentation).

+10

o0-o on Oct 11, 2023

My workaround was to download the latest helm chart and remove the kubeVersion restriction from Chart.yaml.

$ helm repo add rancher https://releases.rancher.com/server-charts/latest
$ helm repo update
$ helm pull rancher/rancher --untar 
# remove kubeVersion from Chart.yaml (https://github.com/rancher/rancher/blob/72f58378bf03122a9651c9bd3b4c143a57e8fdaa/chart/Chart.yaml#L6)
$ helm upgrade --install --create-namespace rancher ./rancher --namespace cattle-system

I can say that Rancher v2.8.0 works without problems with K3s v1.28.4+k3s2. At least for me.

michbeck100 on Dec 7, 2023

I don’t think that a downgrade of k3s can be a solution for this. Please reopen!

michbeck100 on Nov 3, 2023

@Ndeta100 This guide includes the downgrade procedure (replace k3s binary and restart):

https://ozgur-kolukisa.medium.com/installing-rancher-on-k3s-with-helm-charts-309bc7287240

The only caveat I ran into was that on agent nodes, I had to restart the node because the k3s service doesn’t run on them (or wasn’t running on mine at least). Not sure what the appropriate method of downgrading an agent is (I am also new to this).

o0-o on Oct 11, 2023

buen dias / hello

I think o0-o is correct. The latest Kubernetes was released yesterday and Rancher is even certified on 1.28 yet. According to https://kubernetes.io/releases/

Although with the 2.8.0 release last week, maybe documentation just hasn’t caught up https://github.com/rancher/rancher/releases/tag/v2.8.0

rgds sanj

OteemoSanjay on Dec 15, 2023

$ helm template  rancher  rancher-stable/rancher --version v2.7.9
Error: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.28.0

Use --debug flag to render out invalid YAML

Ghostwritten on Dec 15, 2023

@jakubauskas Ran into the same issue. I had to take one of my 8 nodes and turn it into just a Docker system and installed Rancher on that. Then imported the new RKE2 cluster to it.

makton-dev on Dec 6, 2023

any update about this problem?

amundead on Nov 29, 2023

Sorry I closed the issue because we did not have a concrete solution but it’s open now because I still face the same problem as well trying to build a homelab

You closed this because you DIDNT have a solution? thats about as backwards as it gets. Another vote here for rancher and k3s syncing to both have latest mnatch latest. this is a great way to waste a lot of time otherwise.

K3s and Rancher are developed independently. It is not guaranteed that latest Rancher will work with latest K3s.

and they are both developed by Suse which makes this even more bizarre that they wouldnt have a better grasp of how unintuitive that this currently is.

danktankk on Nov 26, 2023

Same on my side. Error: INSTALLATION FAILED: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.28.3

acsaba1977 on Nov 16, 2023

Error: INSTALLATION FAILED: chart requires kubeVersion: < 1.27.0-0 which is incompatible with Kubernetes v1.27.7+k3s2

Same issue here

krdeepu7 on Nov 15, 2023