Step 1: Create an Environment - AWS Cloud9

Step 1: Create an Environment

(First step of Tutorial: Hello AWS Cloud9 (console))

In this step, you use the AWS Cloud9 console to create and then open an AWS Cloud9 development environment.


If you have already created the environment that you want to use for this tutorial, open that environment and skip ahead to Step 2: Basic tour of the IDE.

In AWS Cloud9, a development environment (or just environment) is a place where you store your development project's files and where you run the tools to develop your applications. In this tutorial, you create a special kind of environment called an EC2 environment, and then work with the files and tools in that environment.

Create an EC2 Environment with the console

  1. Sign in to the AWS Cloud9 console as follows:

  2. After you sign in to the AWS Cloud9 console, in the top navigation bar, choose an AWS Region to create the environment in. For a list of available AWS Regions, see AWS Cloud9 in the AWS General Reference.

                AWS Region selector in the AWS Cloud9 console
  3. Choose the large Create environment button in one of the locations shown below.

    If you have no AWS Cloud9 environments yet, the button is shown on a welcome page.

                Welcome page in the AWS Cloud9 console

    If you already have AWS Cloud9 environments, the button is shown as follows.

                Create environment button in the AWS Cloud9 console
  4. On the Name environment page, for Name, enter a name for your environment. For this tutorial, use my-demo-environment.

  5. For Description, enter something about your environment. For this tutorial, use This environment is for the AWS Cloud9 tutorial.

  6. Choose Next step.

  7. On the Configure settings page, for Environment type, choose Create a new instance for environment (EC2).


    Choosing Create a new instance for environment (EC2) might result in possible charges to your AWS account for Amazon EC2.

  8. For Instance type, leave the default choice. This choice has relatively low RAM and vCPUs, which is sufficient for this tutorial.


    Choosing instance types with more RAM and vCPUs might result in additional charges to your AWS account for Amazon EC2.

  9. For Platform, choose the type of Amazon EC2 instance that you want: Amazon Linux or Ubuntu. AWS Cloud9 creates the instance and then connects the environment to it.

  10. Choose a value for Cost-saving setting. When all web browser instances that are connected to the IDE for the environment are closed, AWS Cloud9 waits this amount of time and then shuts down the Amazon EC2 instance for the environment.


    Choosing a longer time period might result in more charges to your AWS account.

  11. Expand Network settings (advanced).

    AWS Cloud9 uses Amazon Virtual Private Cloud (Amazon VPC) to communicate with the newly created Amazon EC2 instance. For this tutorial, we recommend that you don't change the preselected default settings. With the default settings, AWS Cloud9 attempts to automatically use the default VPC with its single subnet in the same AWS account and AWS Region as the new environment.

    You can find more information about Amazon VPC choices in Create an EC2 Environment with the Console, and in VPC settings for AWS Cloud9 Development Environments.

  12. Add up to 50 tags by supplying a Key and a Value for each tag. The tags will be attached to the AWS Cloud9 environment as resource tags, and are propagated to the following underlying resources: the AWS CloudFormation stack, the Amazon EC2 instance, and Amazon EC2 security groups. You can find information about tags in Control Access Using AWS Resource Tags in the IAM User Guide. Also see the advanced information about tags.


    If you update these tags after you create them, the changes are NOT automatically propagated to the underlying resources. For more information, see Propagating Tag Updates to Underlying Resources in the advanced information about tags.

  13. Choose Next step.

  14. On the Review page, choose Create environment. Wait while AWS Cloud9 creates your environment. This can take several minutes.


    If account creation fails, a banner is displayed at the top of the console page. Additionally, the card for the environment, if it exists, indicates that environment creation failed.

After AWS Cloud9 creates your environment, it displays the AWS Cloud9 IDE for the environment.

If AWS Cloud9 doesn't display the IDE after at least five minutes, there might be a problem with your web browser, your AWS access permissions, the instance, or the associated virtual private cloud (VPC). For possible fixes, see Cannot open an environment in Troubleshooting.

Next step

Step 2: Basic tour of the IDE