> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuon.co/llms.txt
> Use this file to discover all available pages before exploring further.

> JSON Schema reference for install configuration

# Install

# Install

## Properties

| Property                                                             | Description                                                                                                                                            | Values         | Example                                        |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- | ---------------------------------------------- |
| **`name`**<br />string                                               | name of the install Unique identifier for this install configuration                                                                                   | **✅ Required** | `"production"`, `"staging"`, `"customer-acme"` |
| **`approval_option`**<br />string                                    | approval option for the install Controls how deployments are approved. Options: 'approve-all' (automatic approval) or 'prompt' (requires confirmation) | **Optional**   | `"approve-all"`, `"prompt"`                    |
| **`labels`**<br />object                                             | key/value labels for the install Tag installs with arbitrary metadata like environment, region, or version.                                            | **Optional**   | `{"env":"production","region":"us-east"}`      |
| **`aws_account`**<br />[AWSAccount](#aws_account)                    | AWS account configuration AWS-specific settings for this install, including region and other account details                                           | **Optional**   | -                                              |
| **`gcp_account`**<br />[GCPAccount](#gcp_account)                    | GCP account configuration GCP-specific settings for this install, including project ID and region                                                      | **Optional**   | -                                              |
| **`azure_account`**<br />[AzureAccount](#azure_account)              | Azure account configuration Azure-specific settings for this install, including the deployment location                                                | **Optional**   | -                                              |
| **`inputs`**<br />array                                              | input values Array of input groups with key-value pairs for customer inputs provided during installation                                               | **Optional**   | -                                              |
| **`stack_overrides`**<br />[InstallStackOverrides](#stack_overrides) | Stack template overrides Per-install overrides for the app-level stack template configuration. Overrides take precedence over app-level defaults.      | **Optional**   | -                                              |
| **`component_toggles`**<br />object                                  | -                                                                                                                                                      | **Optional**   | -                                              |
| **`components`**<br />object                                         | -                                                                                                                                                      | **Optional**   | -                                              |

### `aws_account`

| Property                 | Description                                                     | Values         | Example                                     |
| ------------------------ | --------------------------------------------------------------- | -------------- | ------------------------------------------- |
| **`region`**<br />string | AWS region AWS region where the infrastructure will be deployed | **✅ Required** | `"us-east-1"`, `"us-west-2"`, `"eu-west-1"` |

### `gcp_account`

| Property                     | Description                                                          | Values       | Example                           |
| ---------------------------- | -------------------------------------------------------------------- | ------------ | --------------------------------- |
| **`project_id`**<br />string | GCP project ID GCP project where the infrastructure will be deployed | **Optional** | `"my-gcp-project"`                |
| **`region`**<br />string     | GCP region GCP region where the infrastructure will be deployed      | **Optional** | `"us-central1"`, `"europe-west1"` |

### `azure_account`

| Property                   | Description                                                                    | Values         | Example                                 |
| -------------------------- | ------------------------------------------------------------------------------ | -------------- | --------------------------------------- |
| **`location`**<br />string | Azure location Azure location/region where the infrastructure will be deployed | **✅ Required** | `"eastus"`, `"westus2"`, `"westeurope"` |

### `stack_overrides`

| Property                                     | Description                                                                                                                                                                       | Values       | Example                                                                            |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------- |
| **`vpc_nested_template_url`**<br />string    | VPC nested template URL override Per-install override for the VPC nested CloudFormation template URL. Overrides the app-level default from stack.toml.                            | **Optional** | `"https://nuon-artifacts.s3.us-west-2.amazonaws.com/templates/custom-vpc.yaml"`    |
| **`runner_nested_template_url`**<br />string | Runner nested template URL override Per-install override for the runner nested CloudFormation template URL. Overrides the app-level default from stack.toml.                      | **Optional** | `"https://nuon-artifacts.s3.us-west-2.amazonaws.com/templates/custom-runner.yaml"` |
| **`custom_nested_stacks`**<br />object       | Custom nested stack overrides Per-install overrides for custom nested CloudFormation stacks. Entries with the same name as app-level stacks replace them; new names are appended. | **Optional** | -                                                                                  |