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

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

## Specify configuration overrides


The Apigee hybrid installer uses defaults for many settings; however, there are a few settings
that do not have defaults. You must provide values for these settings, as explained next.

1. Be sure you are in the `hybrid-base-directory/hybrid-files` directory.
2. Copy the `overrides-small.yaml` file from the `` `$APIGEECTL_HOME`/examples `` directory to your `overrides` directory:

       cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides.yaml


   This example file provides a basic configuration for a small-footprint hybrid
   runtime installation, a configuration that is suitable for a your first installation.
3. `cd` into the `overrides` directory:

```
cd overrides
```
4. Open `overrides.yaml` and add the required property values, shown below. A detailed description of each property is also provided below:

   > [!NOTE]
   > **NOTE:** Be sure to disable logging in the overrides file by setting `logger:enabled:false`. Logging is provided by default as part of GKE.

   ### Syntax

   The `overrides.yaml` file has the following structure and syntax.
   Values in <var translate="no">red, bold italics</var> are
   property values that you must provide:

   ```
   gcpProjectID: project-id
   k8sClusterName: cluster-name
   org: org-name

   envs:
     - name: environment-name  # The same name of the env you created in the UI
       hostAlias: test-host-alias
       sslCertPath: ./certs/test-cert-name.pem
       sslKeyPath: ./certs/test-key-name.key
       serviceAccountPaths:
         synchronizer: ./service-accounts/synchronizer-service-account-name.json
         udca: ./service-accounts/udca-service-account-name.json

   mart:
     hostAlias: mart-host-alias
     serviceAccountPath: ./service-accounts/mart-service-account-name.json
     sslCertPath: ./certs/mart-cert-name.pem
     sslKeyPath: ./certs/mart-key-name.key

   metrics:
     serviceAccountPath: ./service-accounts/metrics-service-account-name.json

   logger:
     enabled: false
   ```

   ### Example

   The following example shows a completed overrides file with example property values
   added:

   ```
   gcpProjectID: hybrid-project
   k8sClusterName: apigee-hybrid
   org: hybrid-org

   envs:
     - name: test
       hostAlias: "*"
       sslCertPath: ./certs/keystore.pem
       sslKeyPath: ./certs/keystore.key
       serviceAccountPaths:
         synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
         udca: ./service-accounts/hybrid-project-apigee-udca.json

   mart:
     hostAlias: "mart.apigee-hybrid-docs.net"
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
     sslCertPath: ./certs/fullchain.pem
     sslKeyPath: ./certs/privkey.key

   metrics:
     serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

   logger:
     enabled: false
   ```
5. When your finished, save the file.


The following table describes each of the property values that you must provide in the
overrides file.

| Variable | Description |
|---|---|
| <var translate="no">project-id</var> | Your GCP project ID. |
| <var translate="no">cluster-name</var> | Your Kubernetes cluster name. |
| <var translate="no">org-name</var> | The name of your Apigee hybrid organization. |
| <var translate="no">environment-name</var> | Use the same name that you used when you created an environment in the UI, as explained in [Step 5: Add a new environment in the hybrid UI](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/precog-add-environment.md.txt). |
| <var translate="no">test-host-alias</var> | (Required) For the quickstart, use the wildcard character "`*`". The use of `*` is only recommended for a trial installation when using self-signed TLS credentials. Later, as you develop more complex Apigee hybrid configurations, such as creating multiple environments, you will need to use a qualified domain name for this value. |
| <var translate="no">test-cert-name</var> <var translate="no">test-key-name</var> | Enter the name of the self-signed TLS key and certificate files that you generated previously in the step [Create TLS credentials for the runtime gateway](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-download-install.md.txt#create-tls-credentials-for-the-runtime-gateway). These files must be located in the `base_directory/hybrid-files/certs` directory. For example: ``` sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key ``` |
| <var translate="no"><var translate="no">synchronizer-service-account-name</var></var> | The name of the synchronizer service account key file that you generated with the `create-service-account` tool. For example: ``` synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json ``` |
| <var translate="no"><var translate="no">udca-service-account-name</var></var> | The name of the udca service account key file that you generated with the `create-service-account` tool. For example: ``` udca: ./service-accounts/hybrid-project-apigee-udca.json ``` |
| <var translate="no">mart-host-alias</var> | A qualified DNS name for the MART server endpoint. This name must match the common name (CN) used in the authorized TLS certificate required for this configuration. For example, `mart.mydomain.com` > [!NOTE] > **NOTE:** The Common Name (CN) in the certificate must agree with the value specified in the `mart.hostAlias` property. If the CN is `*.hybrid-domain.net` and you've registered the host `mart.hybrid-domain.net`, then you would set `mart.hostAlias` to the value `mart.hybrid-domain.net`. |
| <var translate="no">mart-service-account-name</var> | The name of the mart service account key file that you generated with the `create-service-account` tool. |
| <var translate="no">mart-cert-name</var> <var translate="no">mart-key-name</var> | Enter the name of the authorized TLS key and certificate files that you generated previously in the step [Create TLS credentials for the MART gateway](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-download-install.md.txt#create-tls-credentials-for-the-mart-gateway). These files must be located in the `base_directory/hybrid-files/certs` directory. For example: ``` sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key ``` |
| <var translate="no"><var translate="no">metrics-service-account-name</var></var> | The name of the metrics service account key file that you generated with the `create-service-account` tool. For example: ``` serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json ``` |

## Summary


The configuration file tells Kubernetes how to deploy the hybrid components to
a cluster. Next, you will apply this configuration to your cluster.
[1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-create-cluster.md.txt) [2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-download-install.md.txt) [3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-copy-overrides.md.txt) [(NEXT) Step 4: Install hybrid runtime](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-apply-hybrid.md.txt)

<br />