AWS CodeDeploy
User Guide (API Version 2014-10-06)

The procedures in this guide support the new console design. If you choose to use the older version of the console, you will find many of the concepts and basic procedures in this guide still apply. To access help in the new console, choose the information icon.

Step 1: Launch a Windows Server Amazon EC2 Instance

To deploy the "Hello, World!" application with AWS CodeDeploy, you need an Amazon EC2 instance running Windows Server.

Follow the instructions in Working with Instances for AWS CodeDeploy. When you are ready to assign an Amazon EC2 instance tag to the instance, be sure to specify the tag key of Name and the tag value of CodeDeployDemo. (If you specify a different tag key or tag value, then the instructions in Step 4: Deploy Your "Hello, World!" Application might produce unexpected results.)

After you've launched the Amazon EC2 instance, return to this page, and continue to the next section. Do not continue on to Create an Application with AWS CodeDeploy as a next step.

Connect to Your Amazon EC2 Instance

After your Amazon EC2 instance is launched, follow these instructions to practice connecting to it.


In these instructions, we assume you are running Windows and the Windows Desktop Connection client application. For information, see Connecting to Your Windows Instance Using RDP. You might need to adapt these instructions for other operating systems or other RDP connection client applications.

  1. Sign in to the AWS Management Console and open the Amazon EC2 console at

  2. In the navigation pane, under Instances, choose Instances.

  3. Browse to and choose your Windows Server instance in the list.

  4. Choose Connect.

  5. Choose Get Password.

  6. Choose Browse. Browse to and choose the Amazon EC2 instance key pair file associated with the Windows Server Amazon EC2 instance, and then choose Open.

  7. Choose Decrypt Password. Make a note of the password that is displayed. You need it in step 10.

  8. Choose Download Remote Desktop File, and then open the file.

  9. If you are prompted to connect even though the publisher of the remote connection can't be identified, proceed.

  10. Type the password you noted in step 7, and then proceed. (If your RDP connection client application prompts you for a user name, type Administrator.)

  11. If you are prompted to connect even though the identity of the remote computer cannot be verified, proceed.

  12. After you are connected, the desktop of the Amazon EC2 instance running Windows Server is displayed.

  13. You can now sign out of the running Amazon EC2 instance.


    Do not stop or terminate the instance. Otherwise, AWS CodeDeploy can't deploy to it.