Install
Properties
| Property | Description | Values | Example |
|---|---|---|---|
namestring | name of the install Unique identifier for this install configuration | ✅ Required | "production", "staging", "customer-acme" |
app_branchstring | app branch name or ID App branch this install belongs to, by name or ID. Changing it moves the install and applies the branch’s latest run. | ✅ Required | "main" |
app_branch_groupstring | app branch deployment group Deployment group this install belongs to within its app branch. This explicit selection takes precedence over label matching. | Optional | "canary" |
approval_optionstring | approval option for the install Controls how deployments are approved. Options: ‘approve-all’ (automatic approval) or ‘prompt’ (requires confirmation) | Optional | "approve-all", "prompt" |
telemetryInstallTelemetry | Install telemetry settings | Optional | - |
labelsobject | key/value labels for the install Tag installs with arbitrary metadata like environment, region, or version. Values can use the .nuon templating syntax to render from install state, and re-render as… | Optional | {"env":"production","region":"{{ .nuon.cloud_account.aws.region }}"} |
aws_accountAWSAccount | AWS account configuration AWS-specific settings for this install, including region and other account details | Optional | - |
gcp_accountGCPAccount | GCP account configuration GCP-specific settings for this install, including project ID and region | Optional | - |
azure_accountAzureAccount | Azure account configuration Azure-specific settings for this install, including the deployment location | Optional | - |
cloud_connectionstring | cloud connection name or ID AWS cloud connection this install uses for provisioning, by name or ID. The connection must exist in the organization and be verified. When omitted, the install falls ba… | Optional | "demo-aws" |
inputsarray | input values Array of input groups with key-value pairs for customer inputs provided during installation | Optional | - |
stack_overridesInstallStackOverrides | Stack template overrides Per-install overrides for the app-level stack template configuration. Overrides take precedence over app-level defaults. | Optional | - |
component_togglesobject | - | Optional | - |
componentsobject | - | Optional | - |
telemetry
| Property | Description | Values | Example |
|---|---|---|---|
enabledboolean | Enable telemetry Enable or disable telemetry for this install. Omit to preserve the current setting; new installs inherit the organization default. | Optional | - |
aws_account
| Property | Description | Values | Example |
|---|---|---|---|
regionstring | AWS region AWS region where the infrastructure will be deployed | ✅ Required | "us-east-1", "us-west-2", "eu-west-1" |
account_idstring | 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_idstring | GCP project ID GCP project where the infrastructure will be deployed | Optional | "my-gcp-project" |
regionstring | GCP region GCP region where the infrastructure will be deployed | Optional | "us-central1", "europe-west1" |
azure_account
| Property | Description | Values | Example |
|---|---|---|---|
locationstring | Azure location Azure location/region where the infrastructure will be deployed | ✅ Required | "eastus", "westus2", "westeurope" |
subscription_idstring | 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_urlstring | 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_urlstring | 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_stacksobject | Custom nested stack overrides Per-install overrides for custom install stacks. Entries with the same name as app-level stacks replace them; new names are appended. Supports AWS CloudFormation, Azur… | Optional | - |