Tanzu Community Edition

Documentation

Support Matrix

The following topic provides details of the supported operating systems, infrastructure providers, and Kubernetes versions.

Local Client/Bootstrap Machine Prerequisites

Before you install Tanzu Community Edition, one of the following operating system and hardware/software configurations is required on your local machine.

Linux Local Bootstrap Machine Prerequisites

Arch: x86; ARM is currently unsupported
RAM: 6 GB
CPU: 2
Docker
In Docker, you must create the docker group and add your user before you attempt to create a standalone or management cluster. Complete steps 1 to 4 in the Manage Docker as a non-root user procedure in the Docker documentation.
Kubectl
Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge
System time is synchronized with a Network Time Protocol (NTP) server.
Ensure your Linux bootstrap machine is using cgroup v1, for more information, see Check and set the cgroup below.

Check and set the cgroup

  1. Check the cgroup by running the following command:

    docker info | grep -i cgroup 
    

    You should see the following output:

    Cgroup Driver: cgroupfs
    Cgroup Version: 1
    
  2. If your Linux distribution is configured to use cgroups v2, you will need to set the systemd.unified_cgroup_hierarchy=0 kernel parameter to restore cgroups v1. See the instructions for setting kernel parameters for your Linux distribution, including:

    Fedora 32+

    Arch Linux

    OpenSUSE

Mac Local Bootstrap Machine Prerequisites

Arch: x86; ARM (M1) currently unsupported
RAM: 6 GB
CPU: 2
Docker Desktop for Mac; Version <= 4.2.0
Kubectl
Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge

Check the cgroup version

  1. Check the cgroup by running the following command:

    docker info | grep -i cgroup 
    

    You should see the following output:

    Cgroup Driver: cgroupfs
    Cgroup Version: 1
    
  2. If you see cgroup version 2, you are running an incompatible version of Docker Desktop. To resolve this, we recommend running Docker Desktop 4.2.0.

    In a future release, we’ll support cgroupsv2 which will resolve this issue. Please follow issue 2798 for progress.

Windows Local Bootstrap Machine Prerequisites

RAM: 8 GB
CPU: 2
Docker Desktop for Windows
Kubectl
Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge

Note: Bootstrapping a cluster to Docker from a Windows bootstrap machine is currently experimental.

Check the cgroup version

  1. Check the cgroup by running the following command:

    docker info | grep -i cgroup 
    

    You should see the following output:

    Cgroup Driver: cgroupfs
    Cgroup Version: 1
    
  2. If you see cgroup version 2, you are running an incompatible version of Docker Desktop. To resolve this, we recommend running Docker Desktop 4.2.0.

    In a future release, we’ll support cgroupsv2 which will resolve this issue. Please follow issue 2798 for progress.

Infrastructure Providers (Target Platforms)

After you install Tanzu Community Edition on your local machine, you can use the Tanzu CLI to deploy a cluster to one of the following infrastructure providers:

Cloud Infrastructure ProviderLocal Infrastructure Provider
Amazon Web Services (AWS)Docker
Microsoft Azure
vSphere

The Cloud Infrastructure providers support the following infrastructure platforms and operating systems (OSs):

vSphereAWSAzure
Infrastructure PlatformvSphere 6.7U3 and later, vSphere 7Native AWSNative Azure
Kubernetes node OSPhoton OS 3, Ubuntu 20.04Amazon Linux 2, Ubuntu 20.04Ubuntu 18.04, Ubuntu 20.04

If you are using Docker as your target infrastructure provider, the following additional configuration is needed:

Local Docker
6 GB of RAM and 4 CPUs (with no other containers running).
15 GB of local machine disk storage for images
Bootstrapping a cluster to Docker from a Windows bootstrap machine is currently experimental.

Note: Check your Docker configuration as follows:

Linux: Run docker system info
Mac and Windows: In Docker Desktop, select Preferences > Resources > Advanced

Support Matrix Summary for Operating System and Infrastructure Provider

The following support matrix provides a summary of the target platforms that are supported for each operating system:

LinuxWindowsMac
Amazon EC2yesyesyes
Dockeryesexperimentalyes
Microsoft Azureyesyesyes
vSphereyesyesyes

Supported Kubernetes Versions

Tanzu Community Edition supports the following Kubernetes versions: 1.21.2, 1.20.8, 1.19.12

Join us!

Our open community welcomes all users and contributors

Community