> [!CAUTION]
> You are currently viewing version 1.4 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.4 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/2-1-install-create-cluster.html)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/2-1-install-create-cluster.html)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/2-1-install-create-cluster.html)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/2-1-install-create-cluster.html)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/2-1-install-create-cluster.html)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/2-1-install-create-cluster.html)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/2-1-install-create-cluster.html)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/2-1-install-create-cluster.html)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/2-1-install-create-cluster.html)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/2-1-install-create-cluster.html)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/2-1-install-create-cluster.html)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/2-1-install-create-cluster.html)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/2-1-install-create-cluster.html)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-1-install-create-cluster.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/2-1-install-create-cluster.html)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/2-1-install-create-cluster.html)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/2-1-install-create-cluster.html)

> [!WARNING]
> **Upgrading:** If you are upgrading to Apigee hybrid version 1.4.4, see [Upgrading Apigee hybrid](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/upgrade.md.txt) for instructions. If you are performing a new installation, continue with the configurations described below.

## Before you begin:


These steps assume you have created environment variables in the previous steps. Check them with
the following commands:

    echo $PROJECT_ID
    echo $ANALYTICS_REGION
    echo $ORG_NAME
    echo $ENV_NAME

### *Click for descriptions and commands to define the variables.*


These steps use the following environment variables:

- <var translate="no">PROJECT_ID</var>: The ID of your Google Cloud project. See [Hybrid
  quickstart - Step 2: Create a Google Cloud project](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-gcpproject)

  ```
  export PROJECT_ID=your_project_ID
  ```
- <var translate="no">ANALYTICS_REGION</var>: The region in which your GKE project is running.The analytics region for your org. See [Hybrid
  quickstart - Step 4: Create an organization](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-provision)

  ```
  export ANALYTICS_REGION=your_analytics region
  ```
- <var translate="no">ORG_NAME</var>: The name of your org. This must match your Google Cloud project ID. See [Hybrid
  quickstart - Step 4: Create an organization](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-provision)

  ```
  export ORG_NAME=your_organization_name
  ```
- <var translate="no">ENV_NAME</var>: The name of your hybrid environment. See [Hybrid
  quickstart - Step 6: Create an environment group](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/precog-add-environment)

  ```
  export ENV_NAME=your_environment_name
  ```


This procedure explains how to set up the cluster in which you will run Apigee hybrid. The
instructions vary depending on the platform in which you are running hybrid. Select your
platform to see the instructions.

### GKE


This step explains how to set up your shell environment and create a GKE cluster
in your Google Cloud project.

> [!CAUTION]
> **Caution:** Apigee does not support [GKE
> Sandbox](https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox-pods) or [gVisor for hybrid installations on GKE](https://github.com/google/gvisor).

## Creating a cluster

1. Gather your cluster requirements for Apigee hybrid cluster:
   - [Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/cluster-overview.md.txt)
   - [Configure dedicated node pools](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/configure-dedicated-nodes.md.txt)
2. Check the version of GKE supported by this version of hybrid version 1.4.4:
   - [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt)
3. Use the following instructions to create a user cluster:
   - [Creating a zonal cluster](https://cloud.google.com/kubernetes-engine/docs/how-to/creating-a-zonal-cluster).


When you have a cluster installed and running, go to the next step.

### GKE on prem

## Cluster resource requirements

For information about cluster resource requirements, see:

- [Anthos GKE production cluster requirements](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/anthos-cluster-setup)
- [Anthos GKE non-production cluster requirements](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/anthos-cluster-non-prod-setup)

## Creating a cluster

1. Gather your cluster requirements for Apigee hybrid cluster:
   - [Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/cluster-overview.md.txt)
   - [Configure dedicated node pools](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/configure-dedicated-nodes.md.txt)
2. Check the version of GKE supported by this version of hybrid version 1.4.4:
   - [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt)
3. Use the following instructions to create a user cluster:
   - [GKE on-prem installation overview](https://cloud.google.com/gke-on-prem/docs/how-to/install-overview-basic) in the GKE on-prem documentation.


When you have a cluster installed and running, go to the next step.

### AKS

## Create an AKS cluster

1. Gather your cluster requirements for Apigee hybrid cluster:
   - [Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/cluster-overview.md.txt)
   - [Configure dedicated node pools](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/configure-dedicated-nodes.md.txt)
2. Check the version of AKS supported by this version of hybrid version 1.4.4:
   - [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt)
3. Use one of the following sets of instructions to create a cluster:
   - Using the Azure CLI: [Quickstart: Deploy an Azure Kubernetes Service cluster using the Azure CLI](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough).
   - Using the Azure Portal: [Quickstart: Deploy an Azure Kubernetes Service (AKS) cluster using the Azure portal](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough-portal).

### EKS

## Creating a cluster

1. Gather your cluster requirements for Apigee hybrid cluster:
   - [Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/cluster-overview.md.txt)
   - [Configure dedicated node pools](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/configure-dedicated-nodes.md.txt)
2. Check the version of EKS supported by this version of hybrid version 1.4.4:
   - [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt)
3. Use the following instructions to create a user cluster:
   - [EKS overview documentation](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html).
   - [Creating an Amazon EKS cluster](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).


When you have a cluster installed and running, go to the next step.

### GKE on AWS

## Creating a cluster

1. Gather your cluster requirements for Apigee hybrid cluster:
   - [Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/cluster-overview.md.txt)
   - [Configure dedicated node pools](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/configure-dedicated-nodes.md.txt)
2. Check the version of GKE supported by this version of hybrid version 1.4.4:
   - [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt)
3. Use the following instructions to create a user cluster:
   - [GKE on AWS overview documentation](https://cloud.google.com/anthos/gke/docs/aws).
   - [Installing GKE on AWS](https://cloud.google.com/anthos/gke/docs/aws/how-to#installing-gke-on-aws).


When you have a cluster installed and running, go to the next step.


[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-1-install-create-cluster.md.txt) [(NEXT) Step 2: Install cert-manager](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-2-install-cert-manager.md.txt) [3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-3-install-asm.md.txt) [4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-4-install-apigeectl.md.txt) [5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-5-install-service-accounts.md.txt) [6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-6-install-configure-cluster.md.txt) [7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/2-7-install-hybrid-runtime.md.txt)

<br />