Rancher Manager v2.8.11
Supported Kubernetes Platforms for Rancher Manager
Important: CentOS has reached end of life. You will no longer find CentOS compatibility within the RKE1, RKE2, or K3S matrices.
| Distro | Lowest Version certified | Highest Version certified on | Notes |
|---|---|---|---|
| RKE2 | v1.25 | v1.28 | See RKE2 Support Matrix for specific system requirements |
| RKE1 | v1.25 | v1.28 | See RKE1 Support Matrix for specific system requirements |
| K3s | v1.25 | v1.28 | See k3s Support Matrix for specific system requirements |
| AKS | v1.25 | v1.28 | |
| EKS | v1.25 | v1.28 | |
| GKE | v1.25 | v1.28 |
Downstream Cluster Support
RKE2
| RKE2 Versions | Rancher Provisioned | Imported |
|---|---|---|
| 1.28 | Yes | Yes |
| 1.27 | Yes | Yes |
| 1.26 | Yes | Yes |
| 1.25 | Yes | Yes |
RKE2 Provisioned Through Rancher
OS | OS Version | Custom 9 | Node Driver9 - SLA Limited Built-In, Active6 | ||||
|---|---|---|---|---|---|---|---|
AWS
| Azure | Digital Ocean | Linode | vSphere 7.0u3, 8.0u2 | |||
| SLES | 15 SP5 | Yes | Yes | Yes | Yes | Yes | Yes |
| 15 SP4 | Yes | Yes | Yes | Yes | Yes | Yes | |
| openSUSE Leap | 15.5 | Yes | Yes | Yes | Yes | Yes | Yes |
| 15.4 | Yes | Yes | Yes | Yes | Yes | Yes | |
| SLE Micro | 5.4 | Imported | N/A | N/A | N/A | N/A | N/A |
| Oracle Linux | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.2 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.1 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.8 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.7 | Yes | Yes | N/A | N/A | N/A | N/A | |
| RHEL | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.2 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.1 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.8 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.7 | Yes | Yes | N/A | N/A | N/A | N/A | |
| Rocky Linux | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 9.2 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 9.1 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.8 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.7 | Yes | Yes | Yes | Yes | Yes | Yes | |
| Ubuntu | 22.04 | Yes | Yes | Yes | Yes | Yes | Yes |
RKE1
| RKE1 Versions | Rancher Provisioned | Imported |
|---|---|---|
| 1.28 | Yes | Yes |
| 1.27 | Yes | Yes |
| 1.26 | Yes | Yes |
| 1.25 | Yes | Yes |
RKE1 Provisioned Through Rancher
OS | OS Version | Validated Docker Version 1 | Custom 9 | Node Driver9 - SLA Limited Built-In, Active6 | ||||
|---|---|---|---|---|---|---|---|---|
AWS
| Azure | Digital Ocean | Linode | vSphere 7.0u3, 8.0u2 | ||||
| SLES | 15 SP5 | 24.0.x | Yes | Yes* | Yes* | Yes* | Yes* | Yes* |
| 15 SP4 | 24.0.x | Yes | Yes* | Yes* | Yes* | Yes* | Yes* | |
| openSUSE Leap | 15.5 | 24.0.x | Yes | Yes* | Yes* | Yes* | Yes* | Yes* |
| 15.4 | 24.0.x | Yes | Yes* | Yes* | Yes* | Yes* | Yes* | |
| SLE Micro | 5.4 | 24.0.x | Imported | N/A | N/A | N/A | N/A | N/A |
| Oracle Linux | 9.3 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| 9.2 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| 9.1 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| 8.9 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| 8.8 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| 8.7 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | N/A | N/A | N/A | N/A | N/A | ||
| RHEL | 9.4 | 25.0.x | Yes | Yes | Yes | Yes | Yes | Yes |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 9.3 | 25.0.x | Yes | Yes | Yes | Yes | Yes | Yes | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 9.2 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 9.1 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.9 | 25.0.x | Yes | Yes | Yes | Yes | Yes | Yes | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.8 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.7 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| Rocky Linux | 9.3 | 25.0.x | Yes | Yes | Yes | Yes | Yes | Yes |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 9.2 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 9.1 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.9 | 25.0.x | Yes | Yes | Yes | Yes | Yes | Yes | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.8 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| 8.7 | 25.0.x | Yes | Yes | N/A | N/A | N/A | N/A | |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
| Ubuntu | 22.04 | 25.0.x | Yes | Yes | Yes | N/A | Yes | Yes |
| 24.0.x | Yes | Yes | Yes | Yes | Yes | Yes | ||
* = Temporary workaround required. Please set Node Template -> Engine Options -> Storage Driver -> Provide overlay2
K3S
| K3s Versions | Rancher Provisioned | Imported |
|---|---|---|
| 1.28 | Yes (x86 Only) | Yes |
| 1.27 | Yes (x86 Only) | Yes |
| 1.26 | Yes (x86 Only) | Yes |
| 1.25 | Yes (x86 Only) | Yes |
K3S Provisioned Through Rancher
OS | OS Version | Custom 9 | Node Driver9 - SLA Limited Built-In, Active6 | ||||
|---|---|---|---|---|---|---|---|
AWS
| Azure | Digital Ocean | Linode | vSphere 7.0u3, 8.0u2 | |||
| SLES | 15 SP5 | Yes | Yes | Yes | Yes | Yes | Yes |
| 15 SP4 | Yes | Yes | Yes | Yes | Yes | Yes | |
| openSUSE Leap | 15.5 | Yes | Yes | Yes | Yes | Yes | Yes |
| 15.4 | Yes | Yes | Yes | Yes | Yes | Yes | |
| SLE Micro | 5.4 | Imported | N/A | N/A | N/A | N/A | N/A |
| Oracle Linux | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.2 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.1 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.8 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.7 | Yes | Yes | N/A | N/A | N/A | N/A | |
| RHEL | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.2 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 9.1 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.8 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.7 | Yes | Yes | N/A | N/A | N/A | N/A | |
| Rocky Linux | 9.4 | Yes | Yes | N/A | N/A | N/A | N/A |
| 9.3 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 9.2 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 9.1 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.10 | Yes | Yes | N/A | N/A | N/A | N/A | |
| 8.9 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.8 | Yes | Yes | Yes | Yes | Yes | Yes | |
| 8.7 | Yes | Yes | Yes | Yes | Yes | Yes | |
| Ubuntu | 22.04 | Yes | Yes | Yes | Yes | Yes | Yes |
Hosted Kubernetes
Provisioned Through Rancher or Registered Existing
| Service | Provider | Highest Version Certified On‡ | Notes |
|---|---|---|---|
| AKS | Microsoft Azure | v1.28 | |
| EKS | Amazon | v1.28 | Amazon Linux 2 is certified on Managed Node Groups |
| GKE | v1.28 |
All Other Distros
Importing Existing Clusters into Rancher
Note: Any other type of Kubernetes cluster can be imported into Rancher.
| Type | Highest Version Certified On‡ |
|---|---|
| Any | v1.25-v1.28 |
| EKS | v1.28 |
| AKS | v1.28 |
| GKE | v1.28 |
Rancher Continuous Delivery
| App Version2 3 4 5 |
|---|
| v0.9.6 |
Cluster API Extension
| Version |
|---|
| v0.11.0 |
For details on supported features, please see the release notes.
Apps & Marketplace
Rancher Apps / Cluster Tools
| Feature | App Name | App Version2 3 4 5 |
|---|---|---|
| Monitoring | rancher-monitoring | 103.2.1+up57.0.3 |
| Alerting | Alerting Drivers | 103.0.2 |
| Istio | rancher-istio | 103.3.1+up1.21.1 |
| Logging | rancher-logging | 103.1.3+up4.8.0 |
| CIS | rancher-cis-benchmark | 5.7.0 |
| Rancher Backup | rancher-backup | 103.0.4+up4.0.4 |
| Prometheus Federator | prometheus-federator | 103.1.0+up0.4.2 |
| NeuVector | neuvector | 103.0.7+up2.8.3 |
| UI Plugin Operator | ui-plugin-operator | 103.0.3+up0.2.2 |
Rancher Longhorn
| Version | Validated/Certified On2 3 4 5 |
|---|---|
| v1.6.2 | Default settings of individual components |
Partner Apps7 8
Legacy App Catalog
| Type | Tag | SLA Applies |
|---|---|---|
| Library | None | To the extent of being able to launch app with default configurations7 |
| Partner | To the extent of being able to launch app with default configurations7 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.
0 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.
00 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
1 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
2 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.
3 whilst running kubernetes clusters in uncertified configurations may be possible, it is not recommended
4 upgrade of any individual component to a different version is likely to result in system downtime
5 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.
6 SLA on node drivers is limited to those that are built-in and active by default when Rancher is installed
7 SLA does not apply to issues within an application and its lifecycle management
8 issues may be referred to the partner as appropriate
9 "custom" means creating a cluster by generating a command line and pasting this command into existing VMs. "node driver" means creating VMs directly from Rancher when it connects to vSphere or other hypervisor
10 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 for all Rancher versions older than Rancher v2.5.x. In Rancher v2.5.x, SLA applies to running Rancher control plane on the listed kubernetes distributions and hosted providers.