CodeBuild CircleCI Support

BoltOps Badge

Please watch/star this repo to help grow and support the project.

Lono is a CloudFormation framework. It builds, manages, and deploys CloudFormation templates.

Lono Features

  • Simple CLI interface to launch CloudFormation stacks.
  • Ability to use Existing CloudFormation Templates.
  • The Lono DSL - Generate templates from beautiful code.
  • Write your CloudFormation parameters with simple env-like values.
  • Preview CloudFormation changes before pressing the big red button.
  • Layering - Allows you to build multiple environments like development and production with the same template.
  • Variables - Allows you to construct templates where runtime Parameters do not suffice.
  • Helpers - Allows you to extend Lono and simplify code.
  • Configsets - Configurement Management. Automatically configure EC2 instances with reuseable code.

See lono.cloud for full lono documentation.


If you are on version 6 and upgrading to 7. You can run lono upgrade within your project. Refer to the Upgrading Guide.

Quick Usage

It only takes a couple of commands to start using lono.

gem install lono
lono new infra
cd infra
lono blueprint new demo
lono cfn deploy demo

Lono flowchart


Here's an example of what the Lono CloudFormation DSL looks like:

description "Demo stack"

parameter("InstanceType", "t3.micro")

  "us-east-1": { Ami: "ami-0de53d8956e8dcf80" },
  "us-west-2": { Ami: "ami-061392db613a6357b" }

resource("Instance", "AWS::EC2::Instance",
  InstanceType: ref("InstanceType"),
  ImageId: find_in_map("AmiMap", ref("AWS::Region"), "Ami"),
  SecurityGroupIds: [get_att("SecurityGroup.GroupId")],
  UserData: base64(user_data("bootstrap.sh"))
resource("SecurityGroup", "AWS::EC2::SecurityGroup",
  GroupDescription: "demo security group",

output("SecurityGroup", get_att("SecurityGroup.GroupId"))

Lono Cfn Deploy

Lono provides a lono cfn lifecycle command that allows you to launch stacks quickly. The lono cfn deploy generates and launches the CloudFormation stack. If you are in a lono project and have a demo lono blueprint. To create a stack run:

$ lono cfn deploy demo


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request