# Nuon documentation

> Deploy your software into customer cloud accounts without cross-account access. Nuon is the BYOC platform for software vendors.

## Docs

- [App Deployment Architecture](https://docs.nuon.co/architecture/byoc.md): Understand what gets deployed into a customer's cloud account.
- [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.
- [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.
- [Customer Portal](https://docs.nuon.co/concepts/customer-portal.md): Let your customers install and manage your app themselves.
- [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
- [Deployment Options](https://docs.nuon.co/deployment-options.md): Control plane and runner deployment options for running Nuon in cloud or self-hosted environments.
- [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
- [Introduction](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.
- [Actions](https://docs.nuon.co/guides/actions.md): Remotely execute custom workflows in installs.
- [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 & Manage Nuon in your AWS account
- [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.
- [Integrate into your Product](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.
- [Use the Customer Portal](https://docs.nuon.co/guides/customer-portal.md): Configure a self-service install portal so customers can deploy and manage their own installs.
- [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.
- [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): Deploy Nuon in your own cloud account
- [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.
- [Nuon Security & Trust](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 operation 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.
- [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.
- [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
- [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

- [Nuon.co](https://nuon.co/)
- [GitHub](https://github.com/nuonco)
- [Slack community](https://join.slack.com/t/nuoncommunity/shared_invite/zt-1q323vw9z-C8ztRP~HfWjZx6AXi50VRA)
- [Knowledge Base](https://support.nuon.co)