Skip to main content
You’ll need two things before you start:
Copy and paste the flow below, or follow the walkthrough underneath for detail on each step of the Quickstart. 
# 1. Install the CLI
brew install nuonco/tap/nuon

# 2. Authenticate with Nuon Cloud
nuon auth login

# 3. Clone Nuon's example apps repo 
git clone https://github.com/nuonco/example-app-configs

# 4. Create the app and sync it with Nuon Cloud. (Kubernetes on AWS shown here)
cd example-app-configs/eks-simple
nuon apps create --name eks-simple
nuon apps sync

# 5. Install the app in your AWS 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.

​
Authenticate to Nuon Cloud

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

​
Clone the Example Apps Repo

Nuon maintains a example apps repo to demonstrate how to package various apps on AWS, Azure and GCP with various architectures like Kubernetes, VM and serverless. 
git clone https://github.com/nuonco/example-app-configs

​
Create and Sync the Example App

For the Quickstart, we’re using an AWS EKS (Kubernetes) app called eks-simple with a whoami Helm component, an ACM certificate, and an Application Load Balancer to access the whoami service. View the app configuration in the example apps repo or with your IDE and the cloned repo. Use the Nuon CLI to create the app then sync its contents into Nuon Cloud. The sync triggers the app’s components (e.g., images, Helm, Kubernetes manifests, Terraform) to be built into OCI artifacts that are stored in your org’s container registry. Nuon will use these artifacts when installing your app. The app name should match the directory name. 
cd example-app-configs/eks-simple
nuon apps create --name eks-simple
nuon apps sync

​
Install the Example App in AWS

Now create an install to deploy the app into your AWS account: 
nuon installs create --name <install-name> --region <region>
  • --name (-n) names this install.
  • --region (-r) is the AWS region to provision into, for example us-east-1.

​
Guided Walkthroughs

For guided walkthroughs including this eks-simple app and EC2 and serverless apps, see Create Your First App.

​
Deploy Your Own App

When you’re ready to package your own software, wrap your existing Terraform, Helm, Kubernetes manifest, and container image assets into a Nuon app — the commands are the same (nuon apps create, nuon apps sync, then nuon installs create). Use agents like Claude Code to build your app by learning from Nuon’s example apps. See our AI and Apps Building docs for more info.