---
# System prepended metadata

title: How to create an example cluster

---

# How to create an example cluster

The `hypershift` CLI tool comes with a command to help create a cluster for demonstration purposes. The cluster will have a default node pool containing two workers nodes.

**Prerequisites:**

- An OpenShift cluster [running HyperShift](/XELV4sPrQ6ycwhrsh9TRZQ)
- Admin access to the OpenShift cluster using the `KUBECONFIG` environment variable
- The [HyperShift CLI](/TaKQKYOYQnyTcoqEJR_Baw)
- The OpenShift `oc` CLI tool.
- A valid pull secret file for image pulls
- An SSH public key file for guest node access
- An [AWS credentials file](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) used to create infrastructure for the cluster

Run the `hypershift` command to generate and install the example cluster:

```shell
hypershift create cluster \
  --pull-secret /my/pull-secret \
  --aws-creds /my/aws-credentials \
  --ssh-key /my/ssh-public-key
```

Eventually the cluster's kubeconfig will become available and can be fetched and decoded locally:

```shell
oc get secret \
  --template={{.data.kubeconfig}} \
  --namespace clusters \
  example-admin-kubeconfig | base64 -D
```
