> ## 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. Values can use the .nuon interpolation syntax to render from install state, and re-render... | **Optional**   | `{"env":"production","region":"{{ .nuon.cloud_account.aws.region }}"}` |
| **`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"` |
| **`account_id`**<br />string | AWS account ID AWS account this install targets. Required when phone home authentication is enabled for the organization. Immutable once the install exists. | **Optional**   | `"123456789012"`                            |

### `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"`  |
| **`subscription_id`**<br />string | Azure subscription ID Azure subscription this install targets. Required when phone home authentication is enabled for the organization. Immutable once the install exists. | **Optional**   | `"00000000-0000-0000-0000-000000000000"` |

### `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** | -                                                                                  |
