> [!CAUTION]
> You are currently viewing version 1.8 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.8 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/install-before-begin.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/install-before-begin.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/install-before-begin.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/install-before-begin.md.txt)
- [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/install-before-begin.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/install-before-begin.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/install-before-begin.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/install-before-begin.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/install-before-begin.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-before-begin.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/install-before-begin.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/install-before-begin.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/install-before-begin.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/install-before-begin.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-before-begin.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-before-begin.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-before-begin.md.txt)

## Supported platforms


See [Apigee hybrid: supported platforms](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt).

## Minimum cluster configurations


Your cluster must meet minimum configuration requirements. For details, see
[Minimum cluster configurations](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/cluster-overview.md.txt).

## Cluster permissions


Each supported platform has its own permission requirements for creating a cluster. As cluster
owner, you can proceed to install the Apigee-specific components (including cert-manager and the
Apigee runtime) into the cluster. However, if you want to delegate to another user the
installation of the runtime components into the cluster, you can manage the necessary permissions
through Kubernetes
[authn-authz](https://kubernetes.io/docs/reference/access-authn-authz/rbac/).


To install the hybrid runtime components into the cluster, a non-cluster-owner user should
have CRUD permission on these resources:

- ClusterRole
- Webhooks (ValidatingWebhookConfiguration and MutatingWebhookConfiguration)
- PriorityClass
- ClusterIssuer
- CustomerResourceDefinitions
- StorageClass (Optional, if the default StorageClass is not used. For information on changing the default and creating a custom storage class, see [StorageClass configuration](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/cassandra-config.md.txt).)

## IAM Roles

## IAM Roles


You need to have the following IAM roles assigned to your user account in order to perform
these steps. If your account does not have these roles, have a user with the roles perform the
steps. For more information on IAM roles, see
[IAM basic and predefined roles reference](https://docs.cloud.google.com/iam/docs/understanding-roles).


To create service accounts and grant them access to your project:

- Create Service Accounts (`roles/iam.serviceAccountCreator`)
- Project IAM Admin (`roles/resourcemanager.projectIamAdmin`)


To grant synchronizer access to your project.

- Apigee Organization Admin (`roles/apigee.admin`)

## Prerequisites

This section describes tasks you must accomplish before you begin the runtime plane quickstart
install.

| Complete the following tasks to ensure that you can successfully begin the runtime installation (as described in this section): |
|---|
| Complete the organization and environment setup steps in [Part 1: Overview](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/precog-overview.md.txt). |
| Have a domain name you can use for your Apigee hybrid installation. |

> [!NOTE]
> **Note about clusters:** You can create a new separate cluster for Apigee hybrid or you can install it in a cluster that is running other workloads.  
>
> - **Shared cluster:** If you install Apigee hybrid in a cluster running other workloads, you need to upgrade and maintain your GKE/AKS cluster at the versions and features required in common for Apigee hybrid and for your other workloads. You may want to develop a plan to migrate one or more workloads if conflicts arise between supported versions and requirements.
> - **Separate cluster:** Creating a dedicated cluster for Apigee hybrid adds isolation. It also adds the operational effort of maintaining the new cluster.
> Both options are valid.

> [!NOTE]
> **Note about VPC Service Controls:** If you plan to enable Google Cloud [Virtual Private Cloud (VPC) Service
> Controls](https://cloud.google.com/vpc-service-controls) with your Apigee hybrid installation, see [Using VPC Service Controls with Apigee and
> Apigee hybrid](https://docs.cloud.google.com/apigee/docs/api-platform/security/vpc-sc) for instructions before you proceed.

|---|
| [Let's get started and create a cluster](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-create-cluster.md.txt) |