Kong with Cassandra DB

Provision Kong resources along with a new Cassandra cluster, using The Datastax Cassandra AMI in a new VPC or existing VPC.


Kong without Cassandra DB

Provisions Kong resources with user provided Cassandra seed nodes in a new VPC or existing VPC.


Kong with Postgres DB

Provisions Kong resources with new or user provided Postgres DB in a new VPC or existing VPC.


Use this cloud formation as a basis for your own, adjust the variables and template to better suite your needs.


  1. Initial Setup:

    Create the required key pairs, one to access Kong instances and one for Cassandra if template povisioning a new Cassandra cluster. If you providing your own DB instances, make sure its accessible by Kong instances. If you want to create instances in existing VPC, VPC need to have two public subnet and all required ports open to allow access to Kong Load balancer.

    Continue to next step if you want to use an existing key pair

  2. Choose a Region & VM Type:

    Choose the region closest to your API servers, and pick the virtualization type you'd like from the list of available templates above.

    You should land on AWS Cloud Formation "Select Template" page

  3. Parameters:

    Fill in all the parameters details. If you chose to launch Kong with Cassandra/Postgres you would be asked to fill in extra parameters to create a Cassandra cluster or Postgres RDS instance. check the description of each field and provide appropriate values.

    Note: consult the templates documentation on Github for detailed description of parameters

  4. Option page:

    Add Tags and other fields according to your requirements.

    Note: The template is configured to add a "Name" tag to each relevant resource

  5. Template Documentation:

    For more details on parameters and futher configuration options, please consult the templates documentation on Github

  6. Grab a Coffee!:

    It will take several minutes (~20 minutes) to create the stack. Once the stack has a status of CREATE_COMPLETE, click on "Output" tab to get the proxy and Admin URL, it may take 60 seconds more for links to become active.

    Note: To monitor the progress go to AWS CloudFormation console, select the stack in the list. In the stack details pane, click the "Events" tab to see the progress.

    Note: Check out the kong-dist-cloudformation repository for further details.
  7. Use Kong:

    Quickly learn how to use Kong with the 5-minute Quickstart.

Having Trouble? We're Here to Help!