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.

​
Install the CLI

If you are not using Homebrew, refer to our CLI documentation for other installation options.

​
Authenticate to Nuon Cloud

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.

​
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.

​
Install the Example App in AWS

Now create an install to deploy the app into your AWS account:
  • --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.