> [!CAUTION]
> 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](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.2 (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).

## About environment creation


Environment creation is a two-step process:

- Create an enviroment in the management plane using either the UI or an Apigee API.
- Add configuration for that environment to your overrides file and apply it to the cluster.

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.2/precog-add-environment.md.txt) and [Specify configuration overrides](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/install-copy-overrides.md.txt#specify-configuration-overrides).

## How to create an environment

1. Create one or more new environments 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.2/precog-add-environment.md.txt).
2. Add a new environment definition to the `envs[]` property in your overrides file.
   Note that the property is an array; therefore, you can add more than one environment definition
   to it.
   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
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json

     - name: prod
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   ...
   ```
3. Add a `virtualhosts` property that maps its `routingRules` to the environment(s).

   ```
   virtualhosts:
     - name: default
       hostAliases: ["api.example.com"]
       sslCertPath: ./certs/fullchain.pem
       sslKeyPath: ./certs/privkey.pem
       routingRules:
         - env: test
   ```
4. Apply any changes to the cluster. If you changed both the `envs[]` and `virtualhosts[]` properties, apply changes with the following command:

   ```
   apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime
   ```


   If you only change the `virtualhosts` property, apply those config changes
   with the `--settings` flag:

   ```
   apigeectl apply -f overrides-file.yaml --settings virtualhosts
   ```


For more information about virtual host configuration, including how to configure
multiple basepath routing rules, see [Configure virtual hosts](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/base-path-routing.md.txt).
For a complete list of environment configuration elements, see [envs](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/config-prop-ref.md.txt#envs) in the
[Configuration
property reference](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/config-prop-ref#envs).