---
title: Setup
description: Before you can deploy the CDK, you must first set up your local environment to communicate with your working Kubernetes cluster.
component: forgeops
version: 7.4
page_id: forgeops::cdk/setup-cdk
canonical_url: https://docs.pingidentity.com/forgeops/7.4/cdk/setup-cdk.html
keywords: ["CDK"]
section_ids:
  windows-cdk: Important information for users running Microsoft Windows
  ARM-cdk: Important information for users running macOS on ARM-based (M1) chipsets
---

# Setup

Before you can deploy the CDK, you must first set up your local environment to communicate with your working Kubernetes cluster.

[Important information for users running Microsoft Windows](#windows-cdk)

[Important information for users running macOS on ARM-based (M1) chipsets](#ARM-cdk)

[icon: empire, set=fab, size=3x]

#### [On Minikube](minikube/setup/mini-setup.html)

Set up a Minikube cluster.

[icon: google, set=fab, size=3x]

#### [On GKE](cloud/setup/gke/gke-setup.html)

Set up your local environment to access a shared cluster on GKE.

[icon: aws, set=fab, size=3x]

#### [On Amazon EKS](cloud/setup/eks/eks-setup.html)

Set up your local environment to access a shared cluster on Amazon EKS.

[icon: microsoft, set=fab, size=3x]

#### [On AKS](cloud/setup/aks/aks-setup.html)

Set up your local environment to access a shared cluster on AKS.

After you've completed these environment setup tasks, you're ready to [deploy the Ping Identity Platform in your namespace on your Kubernetes cluster](deploy.html).

## Important information for users running Microsoft Windows

ForgeRock supports deploying the CDK and CDM using macOS and Linux. If you have a Windows computer, you'll need to create a Linux VM. We tested using the following configurations:

* Hypervisor: Hyper-V, VMWare Player, or VMWare Workstation

* Guest OS: Current Ubuntu LTS release with 12 GB memory and 60 GB disk space

* Nested virtualization enabled in the Linux VM.

**Perform all the procedures in this documentation within the Linux VM. In this documentation, the local computer refers to the Linux VM for Windows users.**

|   |                                                                                                                                                                                                                                                                                                                                                      |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | The Minikube implementation on Windows Subsystem for Linux (WSL2) has networking issues. As a result, consistent access to the ingress controller or the apps deployed on Minikube is not possible. This issue is tracked [here](https://github.com/kubernetes/minikube/issues/7879). Do not deploy CDK or CDM on WSL2 until this issue is resolved. |

## Important information for users running macOS on ARM-based (M1) chipsets

Running the CDK is currently not supported on macOS systems running an ARM-based chipset, such as the Apple M1 or Apple M1 Max.

Refer to [the Release Notes](../rn/limitations.html#platform-limitations) for a workaround.