Skip to main content
Your first app template can take one of two forms, and both install 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 template: your product packaged in Nuon’s configuration format, referencing your existing Terraform, Helm, Kubernetes, and Docker assets.
New to Nuon? Read Nuon App Templates 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. Each example ships through an app branch. If the example’s directory has no branch file (branch.toml or branches/main.toml), add branches/main.toml:
branches/main.toml
Then run:
On Nuon BYOC or Self-Hosted, install the CLI version that matches your control plane instead of the latest. See Choosing a CLI version.

Use Your Own App

When you’re ready to try your product with Nuon, package your existing Terraform, Helm, Kubernetes manifest, and container image assets into a Nuon app template, then install it into your AWS, Azure or GCP. See Configuration Files to structure your app, and Connect GitHub to use private repositories. Use agents like Claude Code to build your app template by learning from Nuon’s example apps. See our AI and App Template Building docs for more info.

Prerequisites