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


This topic explains how to create new environments. For an introduction, see
[About environments and environment groups](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-overview.md.txt).

## How to add an environment


The steps for adding an environment are described in adding and configuring an environment are
explained in [Step 5: Add an environment](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/precog-add-environment.md.txt) and [Specify configuration overrides](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/install-copy-overrides.md.txt#specify-configuration-overrides).

## How to add multiple environments

1. Create a new environment in the [Apigee UI](https://apigee.google.com) or with the [Create environments API](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments/create.md.txt). For the basic steps, see [Step 5: Add an environment](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/precog-add-environment.md.txt).
2. Add a new environment definition to the `envs` array in your overrides file.
   Give the new environment the same name as the one you created in the UI.
   For example, the following configuration defines two environments: **test**
   and **prod**:

   ```
   namespace: my-namespace
   org: my-organization
   ...
   envs:
     - name: test
       sslCertPath: "your_certpath/ingress-cert.crt"
       sslKeyPath: "your_keypath/ingress-key.key"
       hostAlias: "apitest.example.com"
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
     - name: prod
       sslCertPath: "your_certpath/ingress-cert.crt"
       sslKeyPath: "your_keypath/ingress-key.key"
       hostAlias: "apiprod.example.com"
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   ...
   ```


For a complete list of environment configuration elements, see [envs]() in the
[Configuration
property reference](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/config-prop-ref#envs).

## Host aliases with multiple environments


If you have multiple enviroments, each one can have its own host alias, or multiple enviromments
can share the same host alias. For details, see [About virtual hosts and environments](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/environments-about.md.txt#about-virtual-hosts-and-environments) and [Environments can share the same host alias](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/environments-about.md.txt#environments-can-share-the-same-host-alias). If multiple environments share the same
host alias, you must use the technique called [base path routing](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/base-path-routing.md.txt)
to route proxy requests to the correct environment.

## TLS keys and certificates

When you create a new environment, you must provide a TLS key and certificate to the environment
configuration. The key/cert are used to provide secure communication with the ingress gateway.


It is up to you how you generate proper TLS certificate/key pairs for your hybrid
configuration. The following topics are provided as samples only, intended primarily
for trying out or testing a new hybrid installation if it isn't feasible to obtain
TLS credentials in another way:

- See [Obtain TLS credentials](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/lets-encrypt.md.txt) for a set of sample steps for creating an authorized TLS certificate/key pair.
- You can use a self-signed certificate/key pair(s) for testing purposes only. See [Generate self-signed TLS credentials](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/environment-self-signed-tls.md.txt).