Creating an app on AWS

What you will learn

This tutorial will teach you how to create an application on Amazon Web Services (AWS).

AWS Account

This tutorial assumes you already have an AWS account. If you do not have one, read our docs on how to create an AWS account .

AWS Free tier

Amazon Web Services (AWS) provides a generous free tier for new accounts. Read How much will it cost? to learn more.


Creating an application with Coherence

Go to https://app.withcoherence.com/ to create a new account. Click on the “Sign up” link at the bottom of the login form.


Enter your email address and a password then click the “Continue” button.


Complete your profile by filling out the necessary fields and click the continue button at the bottom.

App Details

First, you will need to provide a name for your application.


Cloud project ID

Next, you will need to add your AWS account ID. This can be found by clicking on your account name in the upper right of your AWS dashboard. There is a copy to clipboard button to the right of your account ID which makes it easy for you to simply paste the ID back into Coherence.


Now paste your AWS ID back into Coherence.


Create a repo

Next, we will create a new repo using one of the starter templates provided by the Coherence team. You can, of course, deploy your own application, but using one of our starter templates is the easiest way to get started; allowing you to get a sense of all that the platform offers.

Starter Templates

We are updating these starter templates all of the time, so you may not see the same templates as listed in this tutorial. However, the steps are exactly the same regardless of the starter template you choose.

Click the create button next to the starter template you want to use.

Create a repo

Next, give your repository a name and then click the "Create respository from template" button.

It does not matter if the repo is public or private.



Once your repo is created, copy the URL at the top.


Paste your repo's URL back into Coherence.


Click the continue button

Authorize GitHub

Install the GitHub app

Next, we will need to install the Coherence GitHub app in the starter template repo we just imported. Click on the “Install the app” button.


This will launch a new window so you can configure the Coherence GitHub app. Click on your GitHub account.


You then need to give the Coherence app access to your repository. It is best to give access only to the starter template repo we imported and not “All repositories.” Click the green “Save” button once you have added your repo.


Authorize GitHub

Next, we will need to authorize GitHub so Coherence can push and pull code on our behalf.


Then click on the "Authorize Coherence Platform" button.

Authorize Coherence Platform

You should see a success message.

GitHub auth successful

Close the window and click the Continue button.

GitHub auth successful

Connect cloud

Create a new IAM role

Next, we need to connect AWS with Coherence and create a new IAM role. This will give Coherence the necessary access to create the infrastructure necessary for your app.

First, click on the copy to clipboard button next to the “Custom trust policy” JSON data.


Then within your AWS console, search for “IAM” in the search bar at the top of the page. Then click on the “IAM” service in the search results.


Click on “Roles” in the left sidebar.


Then click the “Create role” button.


Select the “Custom trust policy” tab.


Then, delete the JSON data in the Custom trust policy and paste in the JSON you copied from Coherence.


Click on the “Next” button at the bottom.

Add permissions

Back in Coherence click the copy to clipboard button next to the Permission Policy.


Back in AWS, paste this into the search bar and select “AdministratorAccess.”


Click the “Next” button.

Role name

Finally, back in Coherence, copy the role name.


Paste the role name into AWS.


Click the “Create role” button at the bottom.

You should then see a message that says the role was created.


Now that our role is created, click the “Continue” button in Coherence.



Next, you will be taken to the “Configure Infrastructure” screen. Click the “Configure” button.


Coherence is now creating all of the infrastructure necessary for your application. The process can take up to 20 mins.


Once Coherence has finished setting everything up, you will then have access to the dashboard and can begin using the Coherence platform!

Coherence overview