# Nuon documentation

> Nuon is the BYOC (bring-your-own-cloud) deployment platform for software vendors. Deploy applications — Terraform, Helm, Kubernetes manifests, container images — into customer AWS, Azure, or GCP accounts with no cross-account IAM. Includes runners, operation roles for least-privilege IAM, drift detection, approval workflows, and policies for compliance.

## Docs

- [create action workflow config](https://docs.nuon.co/api-ref/actions/create-action-workflow-config.md): Create an action workflow configuration.
- [create an action workflow run for an install](https://docs.nuon.co/api-ref/actions/create-an-action-workflow-run-for-an-install.md): AppWorkflowConfigId param has been deprecated and is no longer being consumed, the api uses currently install id to lookup related appworkflowconfigId
- [create an app action workflow](https://docs.nuon.co/api-ref/actions/create-an-app.md): Create an action workflow for an app.
- [delete an action workflow](https://docs.nuon.co/api-ref/actions/delete-an-app.md): Delete an action workflow.
- [get action workflow for an app](https://docs.nuon.co/api-ref/actions/get-action-workflow-for-an-app.md): Returns all action workflow configurations.
- [get action workflow runs by install id](https://docs.nuon.co/api-ref/actions/get-action-workflow-runs-by-install-id.md): Returns all action workflow runs for an install.
- [get action workflow runs by install id and run id](https://docs.nuon.co/api-ref/actions/get-action-workflow-runs-by-install-id-and-run-id.md): Return an install action workflow run by id.
- [get action workflows for an app](https://docs.nuon.co/api-ref/actions/get-action-workflows-for-an-app.md): Returns all action workflows for the provided app.
- [get an app action workflow by action workflow id](https://docs.nuon.co/api-ref/actions/get-an-app-action-workflow.md): Return an app action workflow by id.
- [get an app action workflow](https://docs.nuon.co/api-ref/actions/get-an-app-action-workflow-1.md): Return an app action workflow by id.
- [get an app action workflow config](https://docs.nuon.co/api-ref/actions/get-an-app-action-workflow-config.md): Return an action workflow configuration by id.
- [get latest runs for all action workflows by install id](https://docs.nuon.co/api-ref/actions/get-latest-runs-for-all-action-workflows-by-install-id.md): Returns the most recent workflow run for each install action workflow.
- [get recent runs for an action workflow by install id](https://docs.nuon.co/api-ref/actions/get-recent-runs-for-an-action-workflow-by-install-id.md): Returns recent workflow runs for an install action workflow.
- [patch an app](https://docs.nuon.co/api-ref/actions/patch-an-app.md): Update an app action workflow configuration.
- [create an app](https://docs.nuon.co/api-ref/apps/create-an-app.md): Create a new app.
- [Create an app installer](https://docs.nuon.co/api-ref/apps/create-an-app-installer.md)
- [Create an app runner config](https://docs.nuon.co/api-ref/apps/create-an-app-runner-config.md)
- [create an app sandbox config](https://docs.nuon.co/api-ref/apps/create-an-app-sandbox-config.md): Create a sandbox configuration for an app.
- [create an app secret](https://docs.nuon.co/api-ref/apps/create-an-app-secret.md): Create an app secret that can be used to configure components. To reference an app secret, use `.nuon.secrets.<secret_name>`.
- [Create app input configs](https://docs.nuon.co/api-ref/apps/create-app-input-configs.md): App input configs allow you to declare the inputs for your application, and do things such as require customer inputs or  expose configuration knobs in your application.
- [delete an app](https://docs.nuon.co/api-ref/apps/delete-an-app.md): Delete an app.
- [Delete an app installer](https://docs.nuon.co/api-ref/apps/delete-an-app-installer.md)
- [delete an app secret](https://docs.nuon.co/api-ref/apps/delete-an-app-secret.md): Delete an app secret.
- [get all apps for the current org](https://docs.nuon.co/api-ref/apps/get-all-apps-for-the-current-org.md): Returns all apps for the authenticated user.
- [get an app](https://docs.nuon.co/api-ref/apps/get-an-app.md): Return an app.
- [get an app config](https://docs.nuon.co/api-ref/apps/get-an-app-config.md): Fetch an app config by id.
- [get an app config template](https://docs.nuon.co/api-ref/apps/get-an-app-config-template.md): Create an application template which provides a fully rendered config that can be modified and used to kickstart any application.
- [Get an app installer](https://docs.nuon.co/api-ref/apps/get-an-app-installer.md)
- [get app configs](https://docs.nuon.co/api-ref/apps/get-app-configs.md): Returns all configs for the app.
- [Get app input configs](https://docs.nuon.co/api-ref/apps/get-app-input-configs.md)
- [get app runner configs](https://docs.nuon.co/api-ref/apps/get-app-runner-configs.md): Returns all runner configurations for the provided app.
- [get app sandbox configs](https://docs.nuon.co/api-ref/apps/get-app-sandbox-configs.md): Returns all sandbox configurations for the provided app.
- [get app secrets](https://docs.nuon.co/api-ref/apps/get-app-secrets.md): List all secrets for an app.
- [get latest app config](https://docs.nuon.co/api-ref/apps/get-latest-app-config.md): Returns the most recent config for the provided app.
- [get latest app input config](https://docs.nuon.co/api-ref/apps/get-latest-app-input-config.md): Returns the most recent input config for the provided app.
- [get latest app runner config](https://docs.nuon.co/api-ref/apps/get-latest-app-runner-config.md): Returns the most recent runner config for the provided app.
- [get latest app sandbox config](https://docs.nuon.co/api-ref/apps/get-latest-app-sandbox-config.md): Returns the most recent sandbox config for the provided app.
- [Patch v1apps config](https://docs.nuon.co/api-ref/apps/patch-v1apps-config.md): Update an app config, setting status and state.
- [Post v1apps config](https://docs.nuon.co/api-ref/apps/post-v1apps-config.md): Create an app config, by pushing the contents of a config file.
- [Post v1apps input config](https://docs.nuon.co/api-ref/apps/post-v1apps-input-config.md): App input configs allow you to declare the inputs for your application, and do things such as require customer inputs or  expose configuration knobs in your application.
- [Render an app installer](https://docs.nuon.co/api-ref/apps/render-an-app-installer.md)
- [update an app](https://docs.nuon.co/api-ref/apps/update-an-app.md): Update an app's configuration.
- [Update an app installer](https://docs.nuon.co/api-ref/apps/update-an-app-installer.md)
- [create a component](https://docs.nuon.co/api-ref/components/create-a-component.md): Create a new component for an app.
- [create a docker build component config](https://docs.nuon.co/api-ref/components/create-a-docker-build-component-config.md): Create a Docker build component config.
- [create a helm component config](https://docs.nuon.co/api-ref/components/create-a-helm-component-config.md): Create a helm component config.
- [create a terraform component config](https://docs.nuon.co/api-ref/components/create-a-terraform-component-config.md): Create a terraform component config.
- [create an external image component config](https://docs.nuon.co/api-ref/components/create-an-external-image-component-config.md): Create an external image component config.
- [create component build](https://docs.nuon.co/api-ref/components/create-component-build.md): Create a build for a component.
- [delete a component](https://docs.nuon.co/api-ref/components/delete-a-component.md): Delete a component.
- [get a build](https://docs.nuon.co/api-ref/components/get-a-build.md): Returns builds for one or all components in an app.
- [get a build for a component](https://docs.nuon.co/api-ref/components/get-a-build-for-a-component.md): Returns builds for one or all components in an app.
- [get a component](https://docs.nuon.co/api-ref/components/get-a-component.md): Return a component by id.
- [get a component's dependencies](https://docs.nuon.co/api-ref/components/get-a-components-dependencies.md): Returns all dependencies for the provided component.
- [get a components for a specific app](https://docs.nuon.co/api-ref/components/get-a-components-for-a-specific-app.md): Return an app component by id or name.
- [Get all builds for a component](https://docs.nuon.co/api-ref/components/get-all-builds-for-a-component.md)
- [get all components for an app](https://docs.nuon.co/api-ref/components/get-all-components-for-an-app.md): Returns all components for the provided app.
- [get all components for an org](https://docs.nuon.co/api-ref/components/get-all-components-for-an-org.md): Returns all components for the provided organization.
- [get all configs for a component](https://docs.nuon.co/api-ref/components/get-all-configs-for-a-component.md): Returns all configurations for the provided component.
- [get builds for components](https://docs.nuon.co/api-ref/components/get-builds-for-components.md): Returns all builds for the provided component.
- [Get component build logs](https://docs.nuon.co/api-ref/components/get-component-build-logs.md)
- [Get component build plan](https://docs.nuon.co/api-ref/components/get-component-build-plan.md)
- [get latest build for a component](https://docs.nuon.co/api-ref/components/get-latest-build-for-a-component.md): Returns the most recent build for the provided component.
- [get latest config for a component](https://docs.nuon.co/api-ref/components/get-latest-config-for-a-component.md): Returns the most recent config for the provided component.
- [update a component](https://docs.nuon.co/api-ref/components/update-a-component.md): Update a component's configuration.
- [Allow user to be added to an org waitlist.](https://docs.nuon.co/api-ref/general/allow-user-to-be-added-to-an-org-waitlist.md): Add an entry to the waitlist.
- [Get config for cli](https://docs.nuon.co/api-ref/general/get-config-for-cli.md): Returns CLI configuration and settings.
- [Get current user](https://docs.nuon.co/api-ref/general/get-current-user.md): Returns the current authenticated user account.
- [Get jsonschema for config file](https://docs.nuon.co/api-ref/general/get-jsonschema-for-config-file.md): Return jsonschemas for Nuon configs. These can be used in frontmatter in most editors that have a TOML LSP (such as [Taplo](https://taplo.tamasfe.dev/) configured.
- [Get regions for a cloud platform](https://docs.nuon.co/api-ref/general/get-regions-for-a-cloud-platform.md): Return region metadata for the Nuon supported cloud platforms.
- [Publish a metric from different nuon clients for telemetry purposes](https://docs.nuon.co/api-ref/general/publish-a-metric-from-different-nuon-clients-for-telemetry-purposes.md)
- [Create an installer](https://docs.nuon.co/api-ref/installers/create-an-installer.md)
- [Delete an installer](https://docs.nuon.co/api-ref/installers/delete-an-installer.md)
- [Get an installer](https://docs.nuon.co/api-ref/installers/get-an-installer.md)
- [Get installers for current org](https://docs.nuon.co/api-ref/installers/get-installers-for-current-org.md)
- [Render an installer](https://docs.nuon.co/api-ref/installers/render-an-installer.md)
- [Update an installer](https://docs.nuon.co/api-ref/installers/update-an-installer.md)
- [create an app install](https://docs.nuon.co/api-ref/installs/create-an-app-install.md): Create a new install for an app.
- [Create an app install from an installer](https://docs.nuon.co/api-ref/installs/create-an-app-install-from-an-installer.md)
- [create install inputs](https://docs.nuon.co/api-ref/installs/create-install-inputs.md): Create input values for an install.
- [delete an install](https://docs.nuon.co/api-ref/installs/delete-an-install.md): Delete an install.
- [deploy a build to an install](https://docs.nuon.co/api-ref/installs/deploy-a-build-to-an-install.md): Create a new deployment for an install.
- [deploy all components on an install](https://docs.nuon.co/api-ref/installs/deploy-all-components-on-an-install.md): Deploy all components to an install.
- [deprovision an install](https://docs.nuon.co/api-ref/installs/deprovision-an-install.md): Deprovision an install sandbox.
- [get all deploys to an install](https://docs.nuon.co/api-ref/installs/get-all-deploys-to-an-install.md): Returns all deployments for an install.
- [get all installs for an app](https://docs.nuon.co/api-ref/installs/get-all-installs-for-an-app.md): Returns all installs for the provided app.
- [get all installs for an org](https://docs.nuon.co/api-ref/installs/get-all-installs-for-an-org.md): Returns all installs for the provided organization.
- [get an install](https://docs.nuon.co/api-ref/installs/get-an-install.md): Return an install by id.
- [Get an install component](https://docs.nuon.co/api-ref/installs/get-an-install-component.md)
- [get an install component outputs](https://docs.nuon.co/api-ref/installs/get-an-install-component-outputs.md): Return the latest outputs for a component.
- [get an install components deploys](https://docs.nuon.co/api-ref/installs/get-an-install-components-deploys.md): Returns all deployments for an install component.
- [get an install's latest deploy](https://docs.nuon.co/api-ref/installs/get-an-install-deploy.md): Returns the most recent deployment for an install.
- [get an install deploy](https://docs.nuon.co/api-ref/installs/get-an-install-deploy-1.md): Return a deployment for an install by id.
- [get an install event](https://docs.nuon.co/api-ref/installs/get-an-install-event.md): Get a single install event.
- [Get an installer install](https://docs.nuon.co/api-ref/installs/get-an-installer-install.md)
- [get an installs components](https://docs.nuon.co/api-ref/installs/get-an-installs-components.md): Returns all components for an install.
- [get an installs current inputs](https://docs.nuon.co/api-ref/installs/get-an-installs-current-inputs.md): Returns input values for an install.
- [get an installs inputs](https://docs.nuon.co/api-ref/installs/get-an-installs-inputs.md): Returns input values for an install.
- [Get an install's runner group](https://docs.nuon.co/api-ref/installs/get-an-installs-runner-group.md): Return the runner group, including runners and settings for the provided install.
- [get an installs sandbox runs](https://docs.nuon.co/api-ref/installs/get-an-installs-sandbox-runs.md): Returns all sandbox runs for an install.
- [get events for an install](https://docs.nuon.co/api-ref/installs/get-events-for-an-install.md): # Get Install Events
- [Get install deploy plan](https://docs.nuon.co/api-ref/installs/get-install-deploy-plan.md)
- [get install readme rendered with](https://docs.nuon.co/api-ref/installs/get-install-readme-rendered-with.md): Returns the `app.readme` markdown with the values interpolated from the install inputs and component outputs.
- [Get install sandbox run logs](https://docs.nuon.co/api-ref/installs/get-install-sandbox-run-logs.md)
- [get the latest deploy for an install component](https://docs.nuon.co/api-ref/installs/get-the-latest-deploy-for-an-install-component.md): Returns the most recent deployment for an install component.
- [reprovision an install](https://docs.nuon.co/api-ref/installs/reprovision-an-install.md): Reprovision an install sandbox.
- [teardown an install component](https://docs.nuon.co/api-ref/installs/teardown-an-install-component.md): Teardown and remove an install component's resources.
- [teardown an install's components](https://docs.nuon.co/api-ref/installs/teardown-an-installs-components.md): Teardown all components on an install.
- [update an install](https://docs.nuon.co/api-ref/installs/update-an-install.md): Update an install's settings.
- [Updates install input config for app](https://docs.nuon.co/api-ref/installs/update-an-install-input.md): Update input values for an install.
- [Updates install input config for app](https://docs.nuon.co/api-ref/installs/updates-install-input-config-for-app.md): Update input values for an install.
- [Add a user to the current org](https://docs.nuon.co/api-ref/orgs/add-a-user-to-the-current-org.md): Add a user to an organization.
- [create a new org](https://docs.nuon.co/api-ref/orgs/create-a-new-org.md): Create a new organization.
- [Delete an org](https://docs.nuon.co/api-ref/orgs/delete-an-org.md): Delete an organization.
- [Get an org](https://docs.nuon.co/api-ref/orgs/get-an-org.md): Return an organization by id.
- [Get an orgs health checks](https://docs.nuon.co/api-ref/orgs/get-an-orgs-health-checks.md)
- [Get an org's runner group](https://docs.nuon.co/api-ref/orgs/get-an-orgs-runner-group.md): Get the current org's runner group, which includes the runners and their settings.
- [Invite a user to the current org](https://docs.nuon.co/api-ref/orgs/invite-a-user-to-the-current-org.md): Invite a user (by email) to an org.
- [Return current user's orgs](https://docs.nuon.co/api-ref/orgs/return-current-users-orgs.md): Returns all organizations for the authenticated user.
- [Return org invites](https://docs.nuon.co/api-ref/orgs/return-org-invites.md): Returns a list of all invites to the org.
- [Update current org](https://docs.nuon.co/api-ref/orgs/update-current-org.md): Update an organization's settings.
- [Create a release](https://docs.nuon.co/api-ref/releases/create-a-release.md)
- [Get a release](https://docs.nuon.co/api-ref/releases/get-a-release.md)
- [Get a release 1](https://docs.nuon.co/api-ref/releases/get-a-release-1.md)
- [Get all releases for a component](https://docs.nuon.co/api-ref/releases/get-all-releases-for-a-component.md)
- [Get all releases for an app](https://docs.nuon.co/api-ref/releases/get-all-releases-for-an-app.md)
- [Cancel runner job](https://docs.nuon.co/api-ref/runners/cancel-runner-job.md)
- [get a log stream](https://docs.nuon.co/api-ref/runners/get-a-log-stream.md): Return a log stream.
- [get runner job](https://docs.nuon.co/api-ref/runners/get-runner-job.md): Return a runner job.
- [Get runner job execution](https://docs.nuon.co/api-ref/runners/get-runner-job-execution.md)
- [get runner job plan](https://docs.nuon.co/api-ref/runners/get-runner-job-plan.md): Return a plan for a runner job.
- [get runner jobs](https://docs.nuon.co/api-ref/runners/get-runner-jobs.md): Return runner jobs.
- [read a log stream's logs](https://docs.nuon.co/api-ref/runners/read-a-log-streams-logs.md): Read OTEL formatted logs for a log stream.
- [Get a runner](https://docs.nuon.co/api-ref/runnersrunner/get-a-runner.md)
- [Get runner job executions](https://docs.nuon.co/api-ref/runnersrunner/get-runner-job-executions.md)
- [get runner settings](https://docs.nuon.co/api-ref/runnersrunner/get-runner-settings.md): Return runner settings for the provided runner.
- [Get a sandbox](https://docs.nuon.co/api-ref/sandboxes/get-a-sandbox.md)
- [Get all sandboxes](https://docs.nuon.co/api-ref/sandboxes/get-all-sandboxes.md)
- [Get sandbox releases](https://docs.nuon.co/api-ref/sandboxes/get-sandbox-releases.md)
- [create a vcs connection for Github](https://docs.nuon.co/api-ref/vcs/create-a-vcs-connection-for-github.md): Create a VCS connection for version control integration.
- [Get all vcs connected repos for an org](https://docs.nuon.co/api-ref/vcs/get-all-vcs-connected-repos-for-an-org.md)
- [get vcs connection for an org](https://docs.nuon.co/api-ref/vcs/get-vcs-connection-for-an-org.md): Returns all VCS connections for the provided organization.
- [public connection to create a vcs connection via a callback](https://docs.nuon.co/api-ref/vcs/public-connection-to-create-a-vcs-connection-via-a-callback.md): Handle VCS connection callback for OAuth flow.
- [returns a vcs connection for an org](https://docs.nuon.co/api-ref/vcs/returns-a-vcs-connection-for-an-org.md): Return a VCS connection by id.
- [Your App Deployment Diagram](https://docs.nuon.co/architecture/app-deployment.md): Understand what gets deployed into a customer's cloud account when you ship your app through Nuon.
- [Platform Architecture](https://docs.nuon.co/architecture/platform.md): How the Nuon Control Plane and Runners work together to orchestrate BYOC deployments.
- [Runner Authentication](https://docs.nuon.co/architecture/runner-auth.md): How runners prove their cloud identity to the Nuon Control Plane without storing credentials.
- [CLI](https://docs.nuon.co/cli.md): Install the Nuon CLI.
- [Actions](https://docs.nuon.co/concepts/actions.md): Automate operational tasks and workflows in installs.
- [API](https://docs.nuon.co/concepts/api.md): Create and manage installs programmatically via the Nuon Control Plane API.
- [Inputs](https://docs.nuon.co/concepts/app-inputs.md): Inputs allow you to define customer provided values that can be used to configure your app.
- [Secrets](https://docs.nuon.co/concepts/app-secrets.md): Define and manage sensitive values — credentials, API keys, tokens — used to configure app components and actions.
- [App Variables](https://docs.nuon.co/concepts/app-variables.md): App Variables allow you to store values through the API to be used across installs of an app.
- [Nuon Apps](https://docs.nuon.co/concepts/apps.md): Package your existing application code and infrastructure to create Bring Your Own Cloud installable versions of your product.
- [CLI](https://docs.nuon.co/concepts/cli.md): Manage the full install lifecycle from your terminal.
- [Components](https://docs.nuon.co/concepts/components.md): Connect and configure your app using your existing container images, Helm charts, Kubernetes Manifests and Terraform code.
- [Auto Retries](https://docs.nuon.co/concepts/components/auto-retries.md): Configure components to automatically re-plan and re-apply on transient failures by setting max_auto_retries.
- [Dashboard](https://docs.nuon.co/concepts/dashboard.md): What you can do for installs in the Nuon dashboard.
- [Glossary](https://docs.nuon.co/concepts/glossary.md): Basic terminology of the Nuon Platform.
- [Operation Roles](https://docs.nuon.co/concepts/operation-roles.md): Assign different IAM roles to different operations for least-privilege access across sandbox, components, and actions.
- [Concepts](https://docs.nuon.co/concepts/overview.md): Get up to speed on BYOC and Nuon.
- [Policies](https://docs.nuon.co/concepts/policies.md): Enforce compliance, security, and operational standards across your infrastructure deployments.
- [Runners](https://docs.nuon.co/concepts/runners.md): Egress-only agents deployed in customer cloud accounts that execute all provisioning, deployment, and day-2 operations.
- [Sandboxes](https://docs.nuon.co/concepts/sandboxes.md): Sandboxes manage the base layer infrastructure for your application in each customer's cloud account.
- [Stacks](https://docs.nuon.co/concepts/stacks.md): Stacks are cloud-native templates that bootstrap an install in a customer's cloud account.
- [Workflows](https://docs.nuon.co/concepts/workflows.md): Workflows are scheduled and manual lifecycles of deploying, updating or tearing down apps, components, and actions.
- [Action](https://docs.nuon.co/config-ref/action.md): JSON Schema reference for action configuration
- [Break Glass](https://docs.nuon.co/config-ref/break-glass.md): JSON Schema reference for break-glass configuration
- [Container Image](https://docs.nuon.co/config-ref/container-image.md): JSON Schema reference for container-image configuration
- [Docker Build](https://docs.nuon.co/config-ref/docker-build.md): JSON Schema reference for docker-build configuration
- [Helm](https://docs.nuon.co/config-ref/helm.md): JSON Schema reference for helm configuration
- [Configuration Reference](https://docs.nuon.co/config-ref/index.md): Complete reference for Nuon configuration file schemas
- [Input](https://docs.nuon.co/config-ref/input.md): JSON Schema reference for input configuration
- [Input Group](https://docs.nuon.co/config-ref/input-group.md): JSON Schema reference for input-group configuration
- [Inputs](https://docs.nuon.co/config-ref/inputs.md): JSON Schema reference for inputs configuration
- [Install](https://docs.nuon.co/config-ref/install.md): JSON Schema reference for install configuration
- [Installer](https://docs.nuon.co/config-ref/installer.md): JSON Schema reference for installer configuration
- [Kubernetes Manifest](https://docs.nuon.co/config-ref/kubernetes-manifest.md): JSON Schema reference for kubernetes-manifest configuration
- [Metadata](https://docs.nuon.co/config-ref/metadata.md): JSON Schema reference for metadata configuration
- [Permissions](https://docs.nuon.co/config-ref/permissions.md): JSON Schema reference for permissions configuration
- [Policies](https://docs.nuon.co/config-ref/policies.md): JSON Schema reference for policies configuration
- [Policy](https://docs.nuon.co/config-ref/policy.md): JSON Schema reference for policy configuration
- [Runner](https://docs.nuon.co/config-ref/runner.md): JSON Schema reference for runner configuration
- [Sandbox](https://docs.nuon.co/config-ref/sandbox.md): JSON Schema reference for sandbox configuration
- [Secret](https://docs.nuon.co/config-ref/secret.md): JSON Schema reference for secret configuration
- [Secrets](https://docs.nuon.co/config-ref/secrets.md): JSON Schema reference for secrets configuration
- [Stack](https://docs.nuon.co/config-ref/stack.md): JSON Schema reference for stack configuration
- [Terraform](https://docs.nuon.co/config-ref/terraform.md): JSON Schema reference for terraform configuration
- [Configuration Files](https://docs.nuon.co/configuration-files.md): Configure apps using TOML configuration files
- [Dashboard](https://docs.nuon.co/dashboard.md): Manage your Nuon apps and installs using the web-based dashboard
- [Create an AWS EKS App](https://docs.nuon.co/get-started/app-aws-k8s.md): Learn how to package and deploy a Helm app to AWS EKS.
- [Create An AWS Lambda App](https://docs.nuon.co/get-started/app-aws-lambda.md): Learn how to package and install an AWS Lambda app.
- [Create Your First App](https://docs.nuon.co/get-started/create-your-first-app.md): Learn how to package an app to install into AWS
- [Day-2 Operations Overview](https://docs.nuon.co/get-started/day-2-operations.md): BYOC primitives for scaling your deployments
- [Home](https://docs.nuon.co/get-started/introduction.md): Continuous delivery into your customer's cloud.
- [Quickstart](https://docs.nuon.co/get-started/quickstart.md): Get up and running with Nuon in a few minutes.
- [Configure actions](https://docs.nuon.co/guides/actions.md): Define and remotely execute custom action workflows in your installs.
- [Run adhoc actions](https://docs.nuon.co/guides/adhoc-actions.md): Run a one-off command or bash script on an install without defining it in your app's TOML config.
- [AI and App Building](https://docs.nuon.co/guides/ai-and-apps.md): Use AI agents to generate and manage your Nuon app configuration.
- [App Initialization](https://docs.nuon.co/guides/app-init.md): Initialize and scaffold Nuon application configuration files with the CLI.
- [App and Install Life Cycle](https://docs.nuon.co/guides/app-install-life-cycle.md): Understand the life cycle of apps and installs in Nuon.
- [Install Nuon BYOC](https://docs.nuon.co/guides/byoc.md): Let Nuon install and manage Nuon in your own cloud account
- [Nuon BYOC: AWS](https://docs.nuon.co/guides/byoc/aws.md): Install and run Nuon BYOC in your AWS account
- [Nuon BYOC: Azure](https://docs.nuon.co/guides/byoc/azure.md): Install and run Nuon BYOC in your Azure account
- [Nuon BYOC: GCP](https://docs.nuon.co/guides/byoc/gcp.md): Install and run Nuon BYOC in your Google Cloud project
- [CLI Extensions](https://docs.nuon.co/guides/cli-extensions.md): Extend the Nuon CLI with community and first-party plugins.
- [Component Dependencies](https://docs.nuon.co/guides/component-dependencies.md): Component dependencies allow you to create dependencies between components, and model your app as a graph.
- [Configuring Inputs & Secrets](https://docs.nuon.co/guides/configuring-inputs-and-secrets.md): Define and use inputs, variables, and secrets in your app.
- [Configuring Policies](https://docs.nuon.co/guides/configuring-policies.md): Step-by-step guide to adding compliance and security policies to your Nuon app.
- [Configuring Sandboxes](https://docs.nuon.co/guides/configuring-sandboxes.md): Configure sandbox infrastructure for your app.
- [Container Image Components](https://docs.nuon.co/guides/container-image-components.md): Container image components allow you to use prebuilt container images.
- [Add BYOC installation to your app](https://docs.nuon.co/guides/control-plane-integration.md): Enable customers to manage their installs through your UI
- [Custom Domains](https://docs.nuon.co/guides/custom-domains.md): Manage custom domains for an install.
- [Custom Nested CloudFormation Stacks](https://docs.nuon.co/guides/custom-nested-stacks.md): Extend the install stack with custom CloudFormation nested templates.
- [Customizing Terraform Stack Templates](https://docs.nuon.co/guides/customizing-terraform-stack-templates.md): Fork the open-source install-stacks repo to customize the Terraform install stack for your customers.
- [Deployment Options](https://docs.nuon.co/guides/deployment-options.md): Choose how to run Nuon
- [Docker Build Components](https://docs.nuon.co/guides/docker-build-components.md): Docker build components allow you to connect a Dockerfile that will be used to build a container image.
- [External Image Policies](https://docs.nuon.co/guides/external-image-policies.md): Write OPA policies to enforce security requirements on external container images
- [GitHub Actions](https://docs.nuon.co/guides/github-actions.md): Automatically update your Apps from GitHub Actions.
- [Helm Chart Components](https://docs.nuon.co/guides/helm-chart-components.md): Helm chart components allow you to connect an existing Helm chart and deploy it into your customer's cloud account.
- [Install Configs](https://docs.nuon.co/guides/install-configs.md): Generate install configs from code using JSON Schema.
- [Kubernetes Manifest Components](https://docs.nuon.co/guides/kubernetes-manifest-components.md): Kubernetes manifest components allow you to deploy raw Kubernetes resources directly into your customer's cloud account.
- [Managing Apps](https://docs.nuon.co/guides/managing-apps.md): Create, configure, and manage apps using the CLI and dashboard.
- [Managing Components](https://docs.nuon.co/guides/managing-components.md): List, build, and manage components using the CLI.
- [Notifications](https://docs.nuon.co/guides/notifications.md): Send Slack webhook notifications for app and install lifecycle events.
- [Use Nuon Cloud](https://docs.nuon.co/guides/nuon-cloud.md): The fastest way to get started with Nuon
- [Operation Roles](https://docs.nuon.co/guides/operation-roles.md): Assign different roles to different operations across sandbox, components, and actions.
- [Customer-Controlled Runner Shutdown](https://docs.nuon.co/guides/runner-kill-switch.md): How customers can pause or permanently stop the Nuon Runner from their own AWS account.
- [Runner Management Mode](https://docs.nuon.co/guides/runner-management-mode.md): Configure runner management mode for new installs or migrate existing installs.
- [Install Self-Hosted Nuon](https://docs.nuon.co/guides/self-hosted.md): Run Nuon entirely within your own infrastructure, with no path for Nuon to reach in
- [Self-Hosted Nuon: AWS](https://docs.nuon.co/guides/self-hosted/aws.md): Deploy Nuon in your AWS account
- [Self-Hosted Nuon: Azure](https://docs.nuon.co/guides/self-hosted/azure.md): Deploy Nuon in your Azure account
- [Self-Hosted Nuon: GCP](https://docs.nuon.co/guides/self-hosted/gcp.md): Deploy Nuon in your GCP project
- [Team Management](https://docs.nuon.co/guides/team-management.md): Add team members to your Nuon Org
- [Using Terraform CLI](https://docs.nuon.co/guides/terraform-cli.md): Run Terraform commands locally against your Nuon-managed sandbox and component workspaces.
- [Terraform Components](https://docs.nuon.co/guides/terraform-components.md): Terraform components allow you to provision infrastructure in your customer's cloud account to power your install.
- [Using READMEs](https://docs.nuon.co/guides/using-readmes.md): Use READMEs to support operating Installs.
- [Using Variables](https://docs.nuon.co/guides/using-variables.md): Using variables with your Nuon configurations.
- [Connect GitHub](https://docs.nuon.co/guides/vcs.md): Connect your GitHub account to use both public and private repositories in your Nuon apps.
- [Positioning Safety of BYOC](https://docs.nuon.co/guides/vendor-customers.md): Learn how to position Nuon's security and user experience to customers.
- [Webhooks](https://docs.nuon.co/guides/webhooks.md): Receive workflow lifecycle events from your Nuon Org as CloudEvents over HTTP.
- [API](https://docs.nuon.co/nuon-api.md): Get started using the Nuon API endpoints.
- [AWS](https://docs.nuon.co/platform-support/aws.md): Deploy and manage BYOC apps on AWS.
- [Azure](https://docs.nuon.co/platform-support/azure.md): Deploy and manage BYOC apps on Microsoft Azure.
- [Google Cloud](https://docs.nuon.co/platform-support/gcp.md): Deploy and manage BYOC apps on Google Cloud.
- [Introduction](https://docs.nuon.co/platform-support/introduction.md): Overview of supported cloud platforms — AWS, Azure, and Google Cloud — and what's available on each.
- [Pricing](https://docs.nuon.co/pricing.md): Learn more about Nuon's usage based pricing model.
- [SDKs](https://docs.nuon.co/sdks.md): Integrate with different SDKs to embed Nuon in your product.
- [Security](https://docs.nuon.co/security.md): How Nuon keeps customer cloud accounts secure throughout the BYOC deployment lifecycle.
- [Support](https://docs.nuon.co/support/support.md): Get help with the Nuon platform.
- [TUI](https://docs.nuon.co/tui.md): Run entire workflows and trigger install actions via our TUIs
- [001 - Install Workflow Updates](https://docs.nuon.co/updates/001-install-workflows-actions.md): Updates to install workflows, bug fixes and actions improvements.
- [002 - Install Inputs, dependencies, and more](https://docs.nuon.co/updates/002-inputs-dependencies.md): Install Inputs, dependencies and more
- [003 - Improvements to deletions, cancellations and more.](https://docs.nuon.co/updates/003-install-deletes-cancel-improvements.md): Improvements to deletions, cancellations and more.
- [004 - Secrets Syncing](https://docs.nuon.co/updates/004-secrets.md): Automatically sync customer secrets into Kubernetes
- [005 - nuon dev and improvements](https://docs.nuon.co/updates/005-developer-experience.md): `nuon dev` allows you to iterate on configs with a single command, view install state, view an app dependency graph and more.
- [006 - Secrets improvements, workflow retries and bug fixes](https://docs.nuon.co/updates/006-secrets-workflows.md): Secrets improvements, workflow retries and bug fixes.
- [007 - Secret formats, bug fixes](https://docs.nuon.co/updates/007-secret-formats.md): Secrets formats, bug fixes
- [008 - Stack Tab, VCS Import, and Component Build Updates](https://docs.nuon.co/updates/008-vcs-stacks-fixes.md): New stack management features, VCS connection importing, and improved component build system
- [009 - Action Triggers, improved configs, default secrets](https://docs.nuon.co/updates/009-action-triggers-secrets-configs.md): Action triggers, improved configs, default secrets.
- [010 - Approvals](https://docs.nuon.co/updates/010-approvals.md): Workflows now support approvals, so you can verify the helm / terraform plan.
- [011 - Approval Improvements](https://docs.nuon.co/updates/011-approval-updates.md): Inline workflow retries, auto-approve all steps, UI renames, and team member removal.
- [012 - Approval Diffs](https://docs.nuon.co/updates/012-approval-diffs-plan-only.md): Helm teardown diffs, plan-only workflow mode, manual secret sync, and CLI pagination flags.
- [013 - Kubernetes Manifest Component](https://docs.nuon.co/updates/013-kubernetes-manifest-component.md): New Kubernetes Manifest component type for deploying raw Kubernetes resources into customer cloud accounts.
- [014 - Install Config Files](https://docs.nuon.co/updates/014-install-config-files.md): Manage Installs via Source Control
- [015 - Azure Support](https://docs.nuon.co/updates/015-azure-support.md): Deploy and manage installs on Azure
- [016 - Enhanced Install Config Files and Improved Plans](https://docs.nuon.co/updates/016-enhanced-install-config-files-and-improved-plans.md): Directory and file-level install config file syncing. More clear Helm diffs. Improved performance with optimized state management.
- [017 - Noop Approvals, Install Config Improvements and more](https://docs.nuon.co/updates/017-noop-approvals-stability-updates.md): Approvals with no changes will automatically be approved, and more stability fixes.
- [018 - Management Mode](https://docs.nuon.co/updates/018-management-mode.md): Runner Management Mode, input updates, and App Variables for storing values across installs.
- [019 - Self-Service Cloud Registration](https://docs.nuon.co/updates/019-self-service.md): Anyone can now sign up for Nuon Cloud
- [020 - Break glass actions](https://docs.nuon.co/updates/020-break-glass-actions.md): Define actions that customers can enable to break glass.
- [021 - Drift Detection for Components and Sandboxes](https://docs.nuon.co/updates/021-drift-detection.md): Detect infrastructure drift automatically on your installations
- [022 - Nuon CLI Github Action](https://docs.nuon.co/updates/022-nuon-cli-github-actions.md): GitHub Action for setting up the Nuon CLI in CI/CD workflows
- [023 - Drift Scanning Improvements](https://docs.nuon.co/updates/023-drift-workflow-improvements.md): Enhanced drift detection capabilities.
- [024 - Improvements to Install Inputs](https://docs.nuon.co/updates/024-install-inputs-ui-redesign.md): Install inputs via CloudFormation stacks, and user-configurable inputs.
- [025 - Temporal Workflow Stability Improvements](https://docs.nuon.co/updates/025-temporal-stability.md): Fix issues with component workflows retrying.
- [026 - Helm Repository Support](https://docs.nuon.co/updates/026-helm-repository-support.md): Deploy charts directly from public Helm repositories.
- [027 - Install config toggle](https://docs.nuon.co/updates/027-install-config-toggle.md): Clearer install config mode switching.
- [028 - Nuon is now Open Source](https://docs.nuon.co/updates/028-open-source.md): Nuon's core platform is now open source, plus new features and improvements.
- [029 - BYO-VPC, Auth & UX Improvements](https://docs.nuon.co/updates/029-auth-inputs-better-nested-templates.md): BYO-VPC support, Nuon Auth service, Runner Auth, and numerous UX improvements
- [030 - Policies](https://docs.nuon.co/updates/030-policies.md): Enforce compliance, security, and operational standards across component deploys, sandbox runs, and external images.
- [031 - Operation Roles](https://docs.nuon.co/updates/031-operation-roles.md): Assign different roles to different operations across sandbox, components, and actions for least-privilege access control.
- [032 - Nuon TUIs and Extensions, Dashboard UX, and Role Management Updates](https://docs.nuon.co/updates/032-extensions-and-roles.md): We're shipping CLI workflow TUIs, CLI Extensions to GA, dashboard-ui shipped major workflow and onboarding improvements, and ctl-api expanded operation role support.
- [033 - Parallel Workflows, Policy Analytics, and Improved GCP/Azure](https://docs.nuon.co/updates/033-Workflow-Policy-and-improved-cloud-support.md): **New**: Parallel Workflows, Retries, Policy Analytics, Labels  **Improved**: Azure, GCP, Plan Diffs, Runner Management
- [034 - Terraform Stacks for AWS](https://docs.nuon.co/updates/034-aws-terraform-install-stack.md): Provision Stacks in AWS using Terraform.
- [AGENTS](https://docs.nuon.co/updates/AGENTS.md)
- [Changelog](https://docs.nuon.co/updates/updates.md): Learn about new product updates, and what we are working on.

## OpenAPI Specs

- [v3](https://docs.nuon.co/v3)

## Optional

- [Knowledge Base](https://support.nuon.co)