Skip to main content
You’ll need two things before you start:
  • A Nuon account — sign up for the free trial.
  • A test cloud account (AWS, Azure, or GCP) to deploy into. A throwaway or sandbox account is ideal for your first install.
The fastest way to see Nuon work is to deploy one of our example apps into a test cloud account. Copy and paste the flow below, or follow the walkthrough underneath for detail on each step. 
# 1. Install the CLI
brew install nuonco/tap/nuon

# 2. Log in
nuon auth login

# 3. Grab the example apps and pick one (Kubernetes on AWS shown here)
git clone https://github.com/nuonco/example-app-configs
cd example-app-configs/eks-simple

# 4. Define the app from its TOML config
nuon apps create --name eks-simple
nuon apps sync

# 5. Deploy it into your test cloud account
nuon installs create --name <install-name> --region <region>

​
Install the CLI

brew install nuonco/tap/nuon
If you are not using Homebrew, refer to our CLI documentation for other installation options.
The Nuon CLI changes frequently. To ensure you have the latest version, run brew upgrade nuonco/tap/nuon regularly. If you encounter any CLI command errors, please check you are using the latest version.

​
Authenticate

nuon auth login
Follow the prompts in the browser and log in with a Google account.

​
Deploy an Example App

The quickest path is to deploy one of our example apps into a test cloud account. Clone the repo and pick one — eks-simple (Kubernetes on AWS) is a good starting point: 
git clone https://github.com/nuonco/example-app-configs
cd example-app-configs/eks-simple

nuon apps create --name eks-simple
nuon apps sync
Apps are defined in TOML config files and applied with nuon apps sync — not through CLI flags or YAML values. nuon apps create registers the app in the control plane; nuon apps sync uploads the TOML config from the current directory and builds it. The app name should match the directory name.
Now create an install to deploy the app into your test cloud account: 
nuon installs create --name <install-name> --region <region>
  • --name (-n) names this install.
  • --region (-r) is the cloud region to provision into, for example us-west-2.
Deployments are started with nuon installs create — there is no nuon installs deploy command. To redeploy components to an existing install later, use nuon installs deploy-components.
For guided, per-cloud walkthroughs (AWS EKS, EC2, and Lambda) with prerequisites and timings, see Create Your First App.

​
Deploy Your Own App

When you’re ready to package your own software, wrap your existing Terraform, Helm, Kubernetes, and Docker assets into a Nuon app — the commands are the same (nuon apps create, nuon apps sync, then nuon installs create).

Ready to deploy your own app?

Learn how Nuon apps are configured — including connecting a private GitHub repository — then follow Create Your First App for a full walkthrough.