Before continuing with a hybrid installation, you must first create a Kubernetes
cluster in GKE on-prem. There are many variations, some simple and some complex, on how to install GKE on-prem
and create user clusters. To get started,
see Overview of installation
in the GKE on-prem documentation.
Summary
After you have a Kubernetes cluster running in GKE on-prem, you are ready to
install the Apigee hybrid runtime plane software
on the GKE on-prem admin machine.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eVersion 1.2 of the Apigee hybrid documentation is end-of-life and users should upgrade to a newer version, referencing the supported versions page for more information.\u003c/p\u003e\n"],["\u003cp\u003eUsers upgrading from v1.1.x to v1.2.0 should consult the dedicated upgrade instructions, while new installations can proceed with the configurations outlined below.\u003c/p\u003e\n"],["\u003cp\u003eAn Anthos GKE on-prem Kubernetes cluster is a prerequisite for installing Apigee hybrid, and the installation supports Anthos versions 1.2.x and 1.3.x.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid installation does not support GKE Sandbox or gVisor.\u003c/p\u003e\n"],["\u003cp\u003eOnce a Kubernetes cluster is operational in GKE on-prem, the Apigee hybrid runtime plane software can be installed.\u003c/p\u003e\n"]]],[],null,["# Step 1: Create a GKE on-prem cluster\n\n| You are currently viewing version 1.2 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n| **UPGRADING:** If you are upgrading from v1.1.x to v1.2.0, see [Upgrading Apigee hybrid](/apigee/docs/hybrid/v1.2/upgrade) for instructions. If you are performing a new installation, continue with the configurations described below.\n\n\nYou must create a Kubernetes cluster in [Anthos GKE deployed on-prem](https://cloud.google.com/gke-on-prem/docs/overview)\nbefore you can install Apigee hybrid.\n\nCreate a GKE on-prem cluster\n----------------------------\n\n| **NOTE:**The Apigee hybrid installation supports Anthos 1.2.x and Anthos 1.3.x.\n| **Note:** Apigee does not support [GKE Sandbox](https://cloud.google.com/kubernetes-engine/docs/concepts/sandbox-pods) or [gVisor](https://github.com/google/gvisor).\n\n\nBefore continuing with a hybrid installation, you must first create a Kubernetes\ncluster in GKE on-prem. There are many variations, some simple and some complex, on how to install GKE on-prem\nand create user clusters. To get started,\nsee [Overview of installation](https://cloud.google.com/gke-on-prem/docs/how-to/install-overview-basic)\nin the GKE on-prem documentation.\n\nSummary\n-------\n\n\nAfter you have a Kubernetes cluster running in GKE on-prem, you are ready to\ninstall the Apigee hybrid runtime plane software\non the GKE on-prem admin machine.\n[1](/apigee/docs/hybrid/v1.2/install-create-cluster-anthos) [(NEXT) Step 2: Install apigeectl](/apigee/docs/hybrid/v1.2/install-download-install-anthos) [3](/apigee/docs/hybrid/v1.2/install-copy-overrides-anthos) [4](/apigee/docs/hybrid/v1.2/install-apply-hybrid-anthos)\n\n\u003cbr /\u003e"]]
