Skip to main content
The CLI is the primary interface for managing apps. To see all available commands, run nuon apps --help.

​
Creating an App

Create a directory for your app config files in a GitHub repository, then create the app:
The directory can have any name. The app branch’s directory setting tells Nuon where to find it. nuon apps create also selects the new app.

​
Adding the Required Files

A valid app needs these three files. The sandbox and runner are part of Nuon’s BYOC management infra.
metadata.toml
sandbox.toml
runner.toml
Then add a component for each Helm chart, Terraform module, or container image you deploy. The configuration reference covers every file and field.

​
Validating the Config

Check the directory before you push:
It looks up the app by the directory’s name, so it works when the directory and the app share a name.

​
Selecting an App

Select an app to make it the default for all app commands, avoiding the need to pass -a each time:

​
Common Commands

Next, ship your config with an app branch. See Multiple App Configurations.