Learn how to perform tasks using the Nuon platform.

Guides

Nuon documentation

Nuon is a platform for creating BYOC applications.

Introduction

Get up and running with Nuon in a few minutes.

Quickstart

Learn how to package an app for BYOC distribution.

Create Your First App

Configure apps using a single `.toml` file

Configuration Files

Get started using the Nuon API endpoints.

Integrate with different SDKs to embed Nuon in your product.

SDKs

Learn about new product updates, and what we are working on.

Changelog

011 - Approval Improvements

Workflows now support approvals, so you can verify the helm / terraform plan.

010 - Approvals

Action triggers, improved configs, default secrets.

009 - Action Triggers, improved configs, default secrets

New stack management features, VCS connection importing, and improved component build system

008 - Stack Tab, VCS Import, and Component Build Updates

007 - Secret formats, bug fixes

Secrets improvements, workflow retries and bug fixes.

006 - Secrets improvements, workflow retries and bug fixes

`nuon dev` allows you to iterate on configs with a single command, view install state, view an app dependency graph and more.

005 - nuon dev and improvements

Automatically sync customer secrets into Kubernetes

004 - Secrets Syncing

Improvements to deletions, cancellations and more.

003 - Improvements to deletions, cancellations and more.

002 - Install Inputs, dependencies, and more

Updates to install workflows, bug fixes and actions improvements.

001 - Install Workflow Updates

Architecture

Concepts

Package your existing application code and infrastructure to create bring-your-own-cloud installable versions of your product.

Apps

Sandboxes manage the base layer infrastructure for your application in each customer's cloud account.

Sandboxes

Connect and configure your App using your existing container images, infrastructure as code, and DevOps automation.

Components

Installs are instances of an application in a customer cloud account.

Installs

Automate operational tasks and workflows in installs.

Actions

Runners are responsible for deploying, updating and managing installs.

Runners

Inputs allow you to define customer provided values that can be used to configure your App.

Inputs

Secrets allow you to define secrets for an App, that can be used for configuration

Secrets

You can deploy existing apps that use Kubernetes, AWS ECS, AWS Lambda, Azure Kubernetes Service or anything that can be containerized.

Supported Platforms

How to prepare your App for production release with Nuon.

Package

Monitor

Deploy

Debug

Break Glass

Customer Setup

Connect your GitHub account to use both public and private repositories in your Nuon apps.

Connect GitHub

Docker build  components allow you to connect a Dockerfile that will be used to build a container image.

Docker Build Components

Container image Components allow you to use prebuilt container images.

Container Image Components

Terraform Components allow you to provision infrastructure in your customer's cloud account to power your install.

Terraform Components

Helm chart Components allow you to connect an existing Helm chart and deploy it into your customer's cloud account.

Helm Chart Components

Component dependencies allow you to create dependencies between components, and model your app as a graph.

Component Dependencies

Remotely execute custom workflows in installs.

Learn how to grant permissions to Nuon create installs in you or your customer's cloud account.

Install Access Permissions

Using variables with your Nuon configurations.

Using Variables

Use READMEs to support operating Installs.

Using READMEs

How to install an app into customer-provided network.

Bring your Own Network

Custom Domains

Create BYOC apps that can be deployed to customer cloud accounts.

Azure Support

How to test your App without creating real cloud resources.

Sandbox Orgs

Team Management

Notifications

Automatically update your Apps from GitHub Actions.

GitHub Actions

Support

Learn how the Nuon platform can help you create a BYOC offering.

Why Nuon?

Learn why BYOC is becoming the standard delivery model for many applications.

Why BYOC?

Learn more about Nuon's usage based pricing model.

Pricing

Setup Nuon's Terraform provider to manage application configuration.

Terraform provider

Concepts for working with the Nuon platform.

Gain a basic understanding of what Nuon is and how it works.

Glossary

Connect and configure your application using your existing container images, infrastructure as code, and DevOps automation.

Nuon Actions

Installers provide a UI your customers can use to install your app.

Installers

You can deploy existing apps that use Kubernetes, AWS ECS, AWS Lambda or anything that can be containerized. We are currently testing Azure support with a handful of early customers.

App inputs allow you to define customer provided values that can be used to configure your app.

App Inputs

App secrets allow you to define secrets for an app, that can be used for configuration

App Secrets

Container image components allow you to use prebuilt container images.

Terraform components allow you to provision infrastructure in your customer's cloud account to power your install.

Helm chart components allow you to connect an existing Helm chart and deploy it into your customer's cloud account.

Job components are used to execute tasks inside of an install.

Job Components

Use your own IAM roles with customers, using install access delegation

Install Access Delegation

Learn how to create and manage installs using installers, sdks, the cli and more.

Create Installs

Create Builds

How to handle migrations with a BYOC app.

Migrations

Create Releases

How to test your app without creating real cloud resources.

Manage your application configuration using Terraform.

Terraform Configuration Management

Integrate with the Nuon platform from your application code.

SDK integration

Automatically update your apps from GitHub Actions.

Getting Started

Updates

Roadmap

Follow along with features, updates and improvements made to Nuon.

Rename apps, add metadata, notifications and more.

011 - App metadata and notifications

Better support for apps with many customer inputs.

010 - Input Groups, App Secrets and more

Split large app configs into multiple files, better variable support and validation.

009 - Config file improvements

Fork our installer UI and customize it, and build it into your product.

008 - Self Hosted Installers

007 - Nuon Installs UI

006 - Config Files

We have reworked our installers, added a new guide, and reworked some internal infrastructure.

005 - All new installer experience

Integrate Nuon into your workflow and product using our GitHub Actions and SDKs.

004 - GitHub Actions and SDKs

Deploy apps without kubernetes, long live kubernetes!

003 - ECS Support

We shipped a new docs site, and cli login.

001 - New Year, New Docs

Frequently Asked Questions

get all apps for the current org

create an app

get an app

delete an app

update an app

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.


get latest app input config

create an app sandbox config

get app sandbox configs

get latest app sandbox config

get all components for an app

get all components for an org

get a component

update a component

create component build

get latest build for a component

Returns builds for one or all components in an app.


get a build for a component

get all configs for a component

create a docker build component config

create an external image component config

create a helm component config

create a job component config

get latest config for a component

create a terraform component config

create an installer

get an installer

delete an installer

get all installs for an app

create an app install

Forget an install that has been deleted outside of nuon.

This should only be used in cases where an install was broken in an unordinary way and needs to be manually deleted so the parent resources can be deleted.


Production-Readiness Checklist

Configuration

How To

Integrations

Guides

Configuration

How To

Integration