Skip to main content
Version: 2.4.15

Running on ARM64 (Experimental)

> Important: > > Running on an ARM64 platform is currently an experimental feature and is not yet officially supported in Rancher. Therefore, we do not recommend using ARM64 based nodes in a production environment.

The following options are available when using an ARM64 platform:

  • Running Rancher on ARM64 based node(s)

    • Only for Docker Install. Please note that the following installation command replaces the examples found in the Docker Install link:

      # In the last line `rancher/rancher:vX.Y.Z`, be certain to replace "X.Y.Z" with a released version in which ARM64 builds exist. For  example, if your matching version is v2.5.8, you would fill in this line with `rancher/rancher:v2.5.8`. docker run -d --restart=unless-stopped \  -p 80:80 -p 443:443 \  --privileged \  rancher/rancher:vX.Y.Z  

      > Note: To check if your specific released version is compatible with the ARM64 architecture, you may navigate to your
      > version's release notes in the following two ways: > > - Manually find your version using https://github.com/rancher/rancher/releases. > - Go directly to your version using the tag and the specific version number. If you plan to use v2.5.8, for example, you may > navigate to https://github.com/rancher/rancher/releases/tag/v2.5.8.

  • Create custom cluster and adding ARM64 based node(s)

    • Kubernetes cluster version must be 1.12 or higher
    • CNI Network Provider must be Flannel
  • Importing clusters that contain ARM64 based nodes

    • Kubernetes cluster version must be 1.12 or higher

Please see Cluster Options how to configure the cluster options.

The following features are not tested:

  • Monitoring, alerts, notifiers, pipelines and logging
  • Launching apps from the catalog