Skip to main content
Your first app can take one of two forms, and both deploy into a test cloud account:
  • An example app — the fastest way to see Nuon work end to end. Deploy one of our pre-built example app configs without writing any config yourself.
  • Your own app — a real version of your product, packaged from your existing Terraform, Helm, Kubernetes, and Docker assets.
If you’re new to Nuon, start with an example app.
Want the bigger picture first? The App & Install Life Cycle guide walks through packaging, installing, and operating an app.

​
Deploy an Example App

Each guide below deploys a working example into a test 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 (~31 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. 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>

​
Deploy Your Own App

When you’re ready to deploy a real version of your own product, package your existing Terraform, Helm, Kubernetes, and Docker assets into a Nuon app — then install it into a test cloud account before going anywhere near production. The CLI commands are the same as the example above. See how apps are configured to structure your app, including connecting a private GitHub repository.

​
Prerequisites