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

This step explains how to download and install [cert-manager](https://cert-manager.io/docs/), required for Apigee hybrid to operate.

> [!WARNING]
> **Important:** You do not need to do this step if you are performing a fresh installation on a [supported Anthos platform](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt). Anthos (versions 1.8.2 and later) comes with its own version of cert-manager. Apigee can use this Anthos version of cert-manager as long as it is installed in the `cert-manager` namespace (which is the default namespace).
>
>
> If for certain reasons, you need to use your own cert-manager, follow the steps described in
> [Conflicting
> cert-manager installation](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.12/known-issues#conflicting-cert-manager-installation).

## Install cert-manager

1. Use the following command to install cert-manager v1.7.2 from GitHub.

   ```
   kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v1.7.2/cert-manager.yaml
   ```


   You should see a response that the cert-manager namespace and several cert-manager resources
   have been created. For example:

   ```
   customresourcedefinition.apiextensions.k8s.io/certificaterequests.cert-manager.io configured
   customresourcedefinition.apiextensions.k8s.io/certificates.cert-manager.io configured
   ...
   mutatingwebhookconfiguration.admissionregistration.k8s.io/cert-manager-webhook configured
   validatingwebhookconfiguration.admissionregistration.k8s.io/cert-manager-webhook configured
   ```
2. Use the following command to verify the successful creation of cert-manager namespace and its corresponding components:

   ```
     # kubectl get all -n cert-manager -o wide
     
   ```

   Your output should be similar to the following example.
   You should see pods for `cert-manager`, `cert-manager-cainjector`, and `cert-manager-webhook`.

   ```
       NAME                                          READY   STATUS    RESTARTS   AGE    IP          NODE                                       NOMINATED NODE   READINESS GATES
   pod/cert-manager-8568b6f9cb-cz4h2             1/1     Running   0          2d6h   10.56.3.7   gke-cluster-01-apigee-data-d932c3f6-0v1j              
   pod/cert-manager-cainjector-c9c77b797-nk56p   1/1     Running   0          2d6h   10.56.7.2   gke-cluster-01-apigee-data-8a689178-en9x              
   pod/cert-manager-webhook-885b8ffcb-q6vvk      1/1     Running   0          2d6h   10.56.3.2   gke-cluster-01-apigee-data-d932c3f6-0v1j              

   NAME                           TYPE        CLUSTER-IP    EXTERNAL-IP   PORT(S)    AGE   SELECTOR
   service/cert-manager           ClusterIP   10.60.2.36            9402/TCP   91d   app.kubernetes.io/component=controller,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=cert-manager
   service/cert-manager-webhook   ClusterIP   10.60.10.97           443/TCP    91d   app.kubernetes.io/component=webhook,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=webhook

   NAME                                      READY   UP-TO-DATE   AVAILABLE   AGE   CONTAINERS     IMAGES                                            SELECTOR
   deployment.apps/cert-manager              1/1     1            1           91d   cert-manager   quay.io/jetstack/cert-manager-controller:v1.7.2   app.kubernetes.io/component=controller,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=cert-manager
   deployment.apps/cert-manager-cainjector   1/1     1            1           91d   cert-manager   quay.io/jetstack/cert-manager-cainjector:v1.7.2   app.kubernetes.io/component=cainjector,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=cainjector
   deployment.apps/cert-manager-webhook      1/1     1            1           91d   cert-manager   quay.io/jetstack/cert-manager-webhook:v1.7.2      app.kubernetes.io/component=webhook,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=webhook

   NAME                                                DESIRED   CURRENT   READY   AGE   CONTAINERS     IMAGES                                            SELECTOR
   replicaset.apps/cert-manager-8568b6f9cb             1         1         1       91d   cert-manager   quay.io/jetstack/cert-manager-controller:v1.7.2   app.kubernetes.io/component=controller,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=cert-manager,pod-template-hash=8568b6f9cb
   replicaset.apps/cert-manager-cainjector-c9c77b797   1         1         1       91d   cert-manager   quay.io/jetstack/cert-manager-cainjector:v1.7.2   app.kubernetes.io/component=cainjector,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=cainjector,pod-template-hash=c9c77b797
   replicaset.apps/cert-manager-webhook-885b8ffcb      1         1         1       91d   cert-manager   quay.io/jetstack/cert-manager-webhook:v1.7.2      app.kubernetes.io/component=webhook,app.kubernetes.io/instance=cert-manager,app.kubernetes.io/name=webhook,pod-template-hash=885b8ffcb
     
   ```

## Summary


You now have cert-manager installed, and you are ready to install the Apigee hybrid
command-line tool on your local machine.
[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-create-cluster.md.txt) [2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-cert-manager.md.txt) [(NEXT) Step 3: Install apigeectl](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-apigeectl.md.txt) [4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-service-accounts.md.txt) [5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-create-tls-certificates.md.txt) [6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-configure-cluster.md.txt) [7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-enable-synchronizer-access.md.txt) [8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-hybrid-runtime.md.txt) [9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-expose-apigee-ingress.md.txt) [10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/install-deploy-proxy.md.txt)

<br />