Rancher v2.6.3

For this supported product version, open source software and integrations covered by our terms and conditions⁰ are those validated and certified per support matrix⁰⁰ below.

Installing Rancher Server v2.6.3 on RKE

Recommended RKE CLI version

Rancher Version	Recommended CLI Version	Kubernetes Versions
v2.6.3	v1.3.3	v1.21.7 v1.20.13 v1.19.16 v1.18.20

OS & Docker

Type	Version	Validated/certified on¹
CentOS	7.7, 7.8, 7.9	Docker 19.03.x, 20.10.x
	8.3, 8.4 (Until EOL - DEC 2021)	Docker 19.03.x, 20.10.x
Rocky Linux	8.4	Docker 19.03.x, 20.10.x
Oracle Linux	7.7, 7.9	Docker 19.03.x, 20.10.x
	8.2, 8.3, 8.4	Docker 19.03.x, 20.10.x
RHEL	7.7, 7.8, 7.9	RHEL Docker 1.13.x Docker 19.03.x, 20.10.x
	8.2, 8.3, 8.4	Docker 19.03.x, 20.10.x
SLES	12 SP5, 15SP1, 15SP2, 15SP3	Docker 19.03.x, 20.10.x
openSUSE Leap	15.3	19.03.x, 20.10.x
Ubuntu	18.04, 20.04	Docker 19.03.x, 20.10.x

Installing Rancher Server v2.6.3 on K3S

Local Cluster

K3S Version	Validated/certified on^2,3,4,5
v1.21.7+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s1 CRI: embedded Containerd v1.4.12-k3s1 CNI: embedded Flannel v0.15.1
v1.20.13+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.12-k3s1 CNI: embedded Flannel v0.14.1
v1.19.16+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.11-k3s1 CNI: embedded Flannel v0.14.1-k3s.1
v1.18.20+k3s1 (supported on Ubuntu and CentOS/RHEL 7.x only)	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5 MariaDB 10.3.20 External Etcd 3.3.15 CRI: embedded Containerd v1.3.10-k3s1 CNI: embedded Flannel v0.11.0-k3s.2

OS

Type	Version	Validated/certified on¹
Ubuntu	18.04, 20.04	x86_64 architecture
SLES	15SP1, 15SP2, 15SP3	x86_64 architecture
SLE Micro ⁹	5.1	x86_64 architecture
OpenSUSE LEAP	15.3	x86_64 architecture
CentOS	7.8, 7.9, 8.2, 8.3, 8.4(Until EOL - DEC 2021)	x86_64 architecture
Rocky Linux	8.4	x86_64 architecture
RHEL	7.8, 7.9, 8.2, 8.3, 8.4	x86_64 architecture

Installing Rancher Server v2.6.3 on RKE2

Local Cluster

RKE2 Version	Validated/certified on^2,3,4,5
v1.21.7+rke2r2 (Cilium CNI does not support CentOS / RHEL 7.x environments)	Etcd: v3.4.13-k3s1 Containerd: v1.4.12-k3s1 Runc: v1.0.2 Metrics-server: v0.5.0 CoreDNS: v1.8.5 Ingress-Nginx: v4.0.3 Helm-controller: v0.11.7 CNI Plugins: v0.9.1 CNI Canal: Flannel: v0.15.1 Calico: v3.20.1 Calico: v3.19.2 Cilium: v1.10.4 CNI: Multus v3.7.1
v1.20.13+rke2r1 (Cilium CNI does not support CentOS / RHEL 7.x environments)	Etcd: v3.4.13-k3s1 Containerd: v1.4.12-k3s1 Runc: v1.0.2 Metrics-server: v0.5.0 CoreDNS: v1.8.5 Ingress-Nginx: v4.0.3 Helm-controller: v0.11.7 CNI Plugins: v0.9.1 CNI Canal: Flannel: v0.14.1 Calico: v3.13.3 Calico: v3.19.1 Cilium: v1.9.8
v1.19.16+rke2r1	Etcd: v3.4.13-k3s1 Containerd: v1.4.11-k3s1 Runc: v1.0.1 Metrics-server: v0.3.6 CoreDNS: v1.6.9 Ingress-Nginx: v1.36.3 Helm-controller: v0.8.4 CNI Plugins: v0.9.1 CNI Canal: Flannel v0.14.1 Calico: v3.13.3

OS

Type	Version	Validated/certified on¹
Ubuntu	18.04, 20.04	x86_64 architecture
SLES	15SP1, 15SP2, 15SP3	x86_64 architecture
CentOS	7.8, 7.9, 8.2, 8.3, 8.4 (Until EOL - DEC 2021)	x86_64 architecture
Rocky Linux	8.4	x86_64 architecture
OpenSUSE LEAP	15.3	x86_64 architecture
RHEL	7.8, 7.9, 8.2, 8.3, 8.4	x86_64 architecture

Installing Rancher Server v2.6.3 on Hosted Kubernetes

Service	Provider	Highest Version Validated/certified on
AKS	Microsoft Azure	v1.20.9
EKS	Amazon	v1.20.x
GKE	Google	v1.21.5-gke.1302

Downstream Clusters in Rancher v2.6.3

Rancher RKE Downstream Clusters - Linux Worker Nodes

Note: Rancher RKE Downstream clusters can be either provisioned by node drivers or custom/existing nodes, or registered into Rancher

OS & Docker

Type	Version	Validated/certified on¹
CentOS	7.7, 7.8, 7.9	Docker 19.03.x, 20.10.x
	8.2, 8.3 (Until EOL - DEC 2021)	Docker 19.03.x, 20.10.x
Oracle Linux	7.7, 7.9	Docker 19.03.x, 20.10.x
	8.2, 8.3, 8.4	Docker 19.03.x, 20.10.x
RHEL	7.7, 7.8, 7.9	RHEL Docker 1.13.x Docker 19.03.x, 20.10.x
	8.2, 8.3	Docker 19.03.x, 20.10.x
SLES	12SP5, 15SP1, 15SP2,15SP3	Docker 19.03.x, 20.10.x
Ubuntu	18.04, 20.04	Docker 18.06.3, 18.09.x, 19.03.x, 20.10.x
Rocky Linux	8.4	Using custom node provisioning only: Docker 19.03.x, 20.10.x (Rancher node driver provisioning of Docker is not supported)

Supported K8S Versions

Upstream K8S Version	Validated/certified on^2,3,4,5
1.21.7	etcd: v3.4.16 flannel: v0.15.1 canal: v3.19.2 nginx-ingress-controller: 0.49.3-rancher1
1.20.13	etcd: v3.4.15 flannel: v0.15.1 canal: v3.17.2 nginx-ingress-controller: 0.49.3-rancher1
1.19.16	etcd: v3.4.15 flannel: v0.15.1 canal: v3.16.5 nginx-ingress-controller: 0.49.3-rancher1
1.18.20	etcd: v3.4.15 flannel: v0.15.1 canal: v3.13.4 nginx-ingress-controller: 0.35.0-rancher2

Node Drivers

Type	Version	SLA limited to
AWS	N/A	Built-in, Active⁶
Azure	N/A	Built-in, Active⁶
Digital Ocean	N/A	Built-in, Active⁶
Linode	N/A	Built-in, Active⁶
VMware	vSphere 6.5, 6.7, 7.0update 2a	Built-in, Active⁶

Rancher RKE Downstream Clusters - Windows Worker Nodes

Note: Windows clusters are added with Windows worker nodes only.

Supported Windows Server, Docker, K8S Versions

Windows Server	Docker Version	Upstream K8S Version	Windows EOM
Windows Server 2019 LTSC	Docker 19.03.x EE	1.21.x 1.20.x 1.19.x 1.18.x	1/19/2024
20H2 SAC	Docker 19.03.x EE	1.21.x	5/10/2022

Matrix based off of:
Kubernetes/Windows Support:
Windows Support:
Windows Servicing Channels:

Rancher K3S Downstream Clusters

Note: Rancher k3s clusters can only be registered into Rancher, the versions below are supported for importing and upgrading.

OS

Type	Version	Validated/certified on¹
Ubuntu	18.04, 20.04	x86_64 architecture
SLES	15SP1, 15SP2, 15SP3	x86_64 architecture
OpenSUSE LEAP	15.3	x86_64 architecture
CentOS	7.8, 7.9, 8.2, 8.3, 8.4(Until EOL - DEC 2021)	x86_64 architecture
Rocky Linux	8.4	x86_64 architecture
RHEL	7.8, 7.9, 8.2, 8.3, 8.4	x86_64 architecture
SLE Micro	5.0, 5.1	x86_64 architecture

Supported K3S Versions

K3S Version	Validated/certified on^2,3,4,5
v1.21.7+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd v3.4.13 Embedded Etcd v3.4.13-k3s1 CRI: embedded Containerd v1.4.12-k3s1 CNI: embedded Flannel v0.15.1
v1.20.13+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd v3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.12-k3s1 CNI: embedded Flannel v0.14.1
v1.19.16+k3s1	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5, 12.5, 13.1 MariaDB 10.4.8 External Etcd 3.4.13 Embedded Etcd v3.4.13-k3s3 CRI: embedded Containerd v1.4.11-k3s1 CNI: embedded Flannel v0.14.1-k3s.1
v1.18.20+k3s1 (supported on Ubuntu and CentOS/RHEL 7.x only)	Aurora (Mysql 5.7) 2.09.0 MySQL 5.7 PostgreSQL 11.5 MariaDB 10.3.20 External Etcd 3.3.15 CRI: embedded Containerd v1.3.10-k3s1 CNI: embedded Flannel v0.11.0-k3s.2

Rancher RKE2 Downstream Clusters

Note: Rancher RKE2, also known as RKE Government, clusters can be provisioned by Rancher 2.6.0 as a technical preview. The versions listed below are only supported for registering (importing) into Rancher and upgrading.

OS

Type	Version	Validated/certified on¹
CentOS	7.8, 7.9	x86_64 architecture
	8.2, 8.3, 8.4 (Until EOL - DEC 2021)
Rocky Linux	8.4	x86_64 architecture
RHEL	7.8, 7.9, 8.2, 8.3, 8.4	x86_64 architecture
OpenSUSE LEAP	15.3	x86_64 architecture
SLES	15SP1, 15SP2, 15SP3	x86_64 architecture
Ubuntu	18.04, 20.04	x86_64 architecture
SLE Micro	5.0, 5.1	x86_64 architecture

Supported RKE2 Versions

RKE2 Version	Validated/certified on^2,3,4,5
v1.21.7+rke2r2 (Cilium CNI does not support CentOS / RHEL 7.x environments)	Etcd: v3.4.13-k3s1 Containerd: v1.4.12-k3s1 Runc: v1.0.2 Metrics-server: v0.5.0 CoreDNS: v1.8.5 Ingress-Nginx: v4.0.3 Helm-controller: v0.11.7 CNI Plugins: v0.9.1 CNI Canal: Flannel: v0.15.1 Calico: v3.20.1 Calico: v3.19.2 Cilium: v1.10.4 CNI: Multus v3.7.1
v1.20.13+rke2r1 (Cilium CNI does not support CentOS / RHEL 7.x environments)	Etcd: v3.4.13-k3s1 Containerd: v1.4.12-k3s1 Runc: v1.0.2 Metrics-server: v0.5.0 CoreDNS: v1.8.5 Ingress-Nginx: v4.0.3 Helm-controller: v0.11.7 CNI Plugins: v0.9.1 CNI Canal: Flannel: v0.14.1 Calico: v3.13.3 Calico: v3.19.1 Cilium: v1.9.8
v1.19.16+rke2r1	Etcd: v3.4.13-k3s1 Containerd: v1.4.11-k3s1 Runc: v1.0.1 Metrics-server: v0.3.6 CoreDNS: v1.6.9 Ingress-Nginx: v1.36.3 Helm-controller: v0.8.4 CNI Plugins: v0.9.1 CNI Canal: Flannel v0.14.1 Calico: v3.13.3

Hosted Kubernetes Downstream Clusters

Note: Hosted Kubernetes clusters can be either provisioned by Rancher or registered into Rancher

Supported K8S Versions

Service	Provider	Highest Version Validated/certified on	Notes
AKS	Microsoft Azure	1.21.2
EKS	Amazon	v1.21.2-eks-0389ca3	Amazon Linux 2 is certified on Managed Node Groups
GKE	Google	v1.21.6-gke.1500

Other Registered Kubernetes Downstream Clusters

Note: Any other type of registered Kubernetes cluster can be registered

Supported K8S Versions

Type	Highest version validated/certified on^2,3,4,5	Notes
Any	1.21.7 1.20.13 1.19.16 1.18.20
EKS	v1.21.2

Cluster Explorer

Rancher Apps

Feature	App Name	App version^{2 3 4 5}
Alerting and Monitoring	rancher-monitoring	19.0.3
Istio	rancher-istio	1.11.4
Logging	rancher-logging	3.15.0
CIS	rancher-cis-benchmark	2.0.2
Rancher Backup	rancher-backup	2.1.0

Rancher Longhorn

Version	Validated/certified on^{2 3 4 5}
v1.1.3	Default settings of individual components
v1.2.3	Default settings of individual components

Rancher Continuous Delivery (Available in Cluster Explorer)

Version
v0.3.8

Cluster Manager Tools (Legacy)

Tools

Type	Version	Highest Kubernetes Version	Validated/certified on^{2 3 4 5}
Monitoring/Alerts/Notifiers	0.3.1	v1.21.7	0.3.1 prometheus: v2.18.2 prometheus-operator: v0.40.0 prometheus-config-reloader:v0.40.0 prometheus-auth: v0.2.2 node-exporter: v1.0.1 kube-state-metrics: v2.0.0 configmap-reload: v0.3.0 grafana: v7.5.8 nginx: 1.21.1-alpine
Istio Service Mesh	v1.5.920	v1.20.13	istio-citadel: v1.5.9 istio-galley: v1.5.9 istio-proxyv2: v1.5.9 istio-pilot: v1.5.9 istio-mixer: v1.5.9 istio-sidecar_injector: v1.5.9 jaegertracing-all-in-one: v1.14 kiali-kiali: v1.17 istio-node-agent-k8s: v1.5.9 coredns-coredns: v1.6.2 prom-prometheus: v2.12.0 jetstack-cert-manager-controller: v0.8.1
Logging/Project Logging	v0.3.0	v1.20.13	fluentd:v0.1.29 log-aggregator:v0.1.8 configmap-reload:v0.3.0-rancher4
Pipelines	v0.1.4	v1.20.13	pipeline-jenkins-server:v0.1.4 pipeline-tools:v0.1.16 mirrored-jenkins-jnlp-slave:4.7-1
CIS	CIS 1.5	v1.20.13	security-scan:v0.1.14

Cluster Manager Catalog

Type	Tag	SLA applies
Library	None	To the extent of being able to launch app with default configurations⁷
	Partner	To the extent of being able to launch app with default configurations^{7 8}
	Experimental	N/A

^† All “latest” tagged releases are intended for the Rancher community users to test-drive a new release and provide feedback. These “latest” tagged releases whilst covered by Rancher SLA are not generally meant for production use cases. Kindly use only the “stable” tagged releases for your own production use cases.

⁰ For open source components not listed in the matrix above, support is limited to troubleshooting for root cause up to Rancher’s drivers and interfaces to those components. Root causes that are identified to be beyond this limit will need to be pursued by Company with the maintainers and providers of commercial support for those components.

⁰⁰ for ensuring best support and clarity on supportability, Company is recommended to publish to Rancher a list of components that are critical to its deployment but not not explicitly called out in the support matrix

¹ certified on default OS kernel. Issues resulting from third party tools (typically, for reasons such as security) interfering with Docker or other necessary system calls are deemed resolved should disabling such tools restore functionality

² certified configurations are based on default settings of individual components. Where Company has deviated from certified configurations, Rancher Labs reserves the right to recommend the Company to revert to a certified configuration to resolve the reported issue.

³ whilst running kubernetes clusters in uncertified configurations may be possible, it is not recommended

⁴ upgrade of any individual component to a different version is likely to result in system downtime

⁵ changes to default settings of individual components may be necessary on exceptional basis, for reasons such as fine tuning for performance and scale. Engagement with Rancher Consulting or a partner may be recommended.

⁶ SLA on node drivers is limited to those that are built-in and active by default when Rancher is installed

⁷ SLA does not apply to issues within an application and its lifecycle management

⁸ issues may be referred to the partner as appropriate

⁹ Currently Rancher Server running on k3s under SLE Micro has two support exceptions: (1) Rancher Logging has a permission issue on SLE Micro 5.1 and is not functioning (2) Rancher CIS scanning tool has issues with the way it is checking journalctl

^‡ SLA is limited to running workload clusters on hosted kubernetes provider and does not apply to running the Rancher control plane on one of the listed hosted kubernetes providers

Support Matrix

RANCHER 2.10.X

RANCHER 2.9.X

RANCHER 2.8.X

RANCHER 2.7.X

RANCHER 2.6.X

RANCHER 2.5.X

RANCHER 2.4.X

RKE 1

RKE 2

K3S

HARVESTER

LONGHORN

NEUVECTOR

Rancher v2.6.3

Installing Rancher Server v2.6.3 on RKE

Recommended RKE CLI version

OS & Docker

Installing Rancher Server v2.6.3 on K3S

Local Cluster

OS

Installing Rancher Server v2.6.3 on RKE2

Local Cluster

OS

Installing Rancher Server v2.6.3 on Hosted Kubernetes

Downstream Clusters in Rancher v2.6.3

Rancher RKE Downstream Clusters - Linux Worker Nodes

OS & Docker

Supported K8S Versions

Node Drivers

Rancher RKE Downstream Clusters - Windows Worker Nodes

Supported Windows Server, Docker, K8S Versions

Rancher K3S Downstream Clusters

OS

Supported K3S Versions

Rancher RKE2 Downstream Clusters

OS

Supported RKE2 Versions

Hosted Kubernetes Downstream Clusters

Supported K8S Versions

Other Registered Kubernetes Downstream Clusters

Supported K8S Versions

Cluster Explorer

Rancher Apps

Rancher Longhorn

Rancher Continuous Delivery (Available in Cluster Explorer)

Cluster Manager Tools (Legacy)

Tools

Cluster Manager Catalog