Skip to main content
Your first app can take one of two forms, and both deploy into your cloud account:
  • An example app (recommended) — the fastest way to see Nuon work end to end. Use one of our pre-built example apps.
  • Your own app — your app packaged in Nuon’s configuration format and referencing your existing Terraform, Helm, Kubernetes, and Docker assets.
New to Nuon? Read the App & Install Life Cycle guide to understand how apps are packaged, installed and managed with Nuon.

​
Use an Example App

Each guide below deploys a working example into your AWS account:
  • eks-simple: An AWS EKS (Kubernetes) Traefik whoami application (~35 min)
  • cde: An AWS EC2 VM you connect to with ssh and VS Code Web (~26 min)
  • aws-lambda: A Lambda function with DynamoDB and API Gateway (~26 min)
Estimated times above include creating the initial VPC, Subnets, Nat Gateway, ASG, EC2 VM, and a healthy Nuon runner (~11 min). For the fastest duration, approve all workflow steps when the app install begins. cde and aws-lambda are less resource and cost intensive than eks-simple which provisions a Kubernetes cluster with 3 nodes. For these and other examples, clone the example-app-configs repository and run: 
brew install nuonco/tap/nuon
nuon auth login
cd example-app-configs/<app directory>
nuon apps create --name <app directory>
nuon apps sync
nuon installs create --name <install-name> --region <region>

​
Use Your Own App

When you’re ready to try your app with Nuon, package your existing Terraform, Helm, Kubernetes manifest, and container image assets into a Nuon app — then install it into your AWS, Azure or GCP. See how apps are configured to structure your app, including connecting a GitHub repository. 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.

​
Prerequisites