Skip to main content

cluster create

Create clusters for compatibility testing. For more information, see About the Compatibility Matrix.


replicated cluster create [flags]
FlagType (if applicable)Description
-h, --helpHelp for the command.
--diskintegerThe disk size (GiB) to request per node. Default: 50
--distributionstringThe Kubernetes cluster distribution type to provision. Default: kind
--dry-runThe dry run option runs a simulated test to verify that your inputs are valid without actually creating a cluster.
--instance-typestringThe type of instance to use for nodes in the cluster. For supported instance types, see Supported Compatibility Matrix Cluster Types (Beta).
--licensestringA valid customer license ID. Required for Replicated embedded cluster distribution.
--namestringThe name of the cluster. If no name is specified, a name will be generated.
--nodesintegerThe node count. Default: 1
--min-nodesstringMinimum Node count (only for EKS, AKS and GKE clusters).
--max-nodesstringMaximum Node count (only for EKS, AKS and GKE clusters).
--nodegroupstringNode group to create (name=?,instance-type=?,nodes=?,min-nodes=?,max-nodes=?,disk=? format, can be specified multiple times)

The output format to use. Valid values: json or table. Some commands also support wide Default: table

--tagstringTag to apply to the cluster (key=value format, can be specified multiple times)

The cluster Time to Live (TTL) duration, in hours or minutes. When the TTL expires, the cluster is automatically deleted.

Valid values: 10m through 48h. For example, 10h or 120min. TTL starts when the cluster is in a Ready state. Valid values: 1h through 48h. Default: 1h

--versionstringThe Kubernetes version to provision. For OpenShift clusters, provide the supported OpenShift version. The format is distribution dependent. For supported versions, see Supported Compatibility Matrix Cluster Types.
--waitdurationThe wait duration for the cluster to be ready. Leave the value empty to avoid waiting.


  • For an EKS distribution:

    replicated cluster create --name eks-example --distribution eks --version 1.27 --node-count 3 --instance-type m6i.large
  • For an EKS distribution with an additional node group:

    replicated cluster create --name eks-nodegroup-example --distribution eks --instance-type m6i.large --nodes 1 --nodegroup name=arm,instance-type=m7g.large,nodes=1,disk=50
  • For a kind distribution:

    replicated cluster create --name kind-example --distribution kind --version 1.25.2 --disk 100 --instance-type r1.small
  • For a Replicated embedded cluster distribution:

replicated cluster create --distribution embedded-cluster --license-id <license-id>