How to Set Up Apprenda in Amazon Web Services [Tutorial]

By Atos Apprenda Support

We’ve just launched the public availability of a single-node installation of Apprenda in Amazon Web Services (AWS) using our pre-configured Amazon Machine Image, which is yet another example of our commitment to interoperability and accessibility.

The tutorial that follows walks you through how you can get Apprenda 5.5 up and running immediately in AWS today.


  • An Amazon Web Services Account (Please sign up here if you do not have one.)
  • If you are using a Mac, have a remote desktop solution ready. Microsoft offers one for free in the Mac App Store here.
  • Optionally, the AWS Command Line Interface if you wish to provision from the command line. Download it here.

Step-by-Step Guide

  1. Launch the Amazon Web Services EC2 Management Console. You should see the “Launch Instance” button.
  2. From there, click on the Community AMIs section and search for “Apprenda.” The latest AMI will be available for selection.
  1. Configure your instance as you normally would any other Amazon EC2 Instance. I’ve compiled some useful links for both Apprenda and Amazon EC2.

When choosing the instance type, we strongly recommend using an m3.medium instance or larger for performance reasons. Also, if you select an instance type that requires VPC, ensure that you have access to that VPC or assign a public IP address to it.

  1. After your instance has launched, you must next configure an Elastic IP address to assign to our new instance. This is important, especially if you would like to shut down your instance at any point in the future to save the hourly cost. Amazon EC2 by default re-assigns you a new IP address if you do not reserve and assign an Elastic IP. This step needs to be done prior to connecting the first time. For more information on how to do this, please check the AWS documentation here.
  2. Once configured, launch the instance and return to the EC2 Instances display. Click on your newly provisioned instance and then click Connect.

Important: You will have to retrieve your password after you have set up your EC2 private key to connect to your instance. In the image above, please click on “Get Password” and follow the instructions provided. For more information, please refer to AWS documentation regarding this.

  1. Click on Download Remote Desktop File and open the RDP file. Use the default password (listed above) to login via Remote Desktop and to connect to our Apprenda Instance.

You might see warning notifications, such as these below. You can safely ignore these and continue on.


  1. Once you are logged into the system, a Powershell screen will automatically open and guide you through the configuration of your Instance. Press enter to begin the configuration of Apprenda. Your screen will begin to update. It will ask you for your email address to set your account up as the platform administrator. Once completed, it will finish the Apprenda installation and create two shortcuts on the Desktop: one for the Developer Portal and one for the System Operation Center (SOC).


  1. Start to deploy your .NET apps!

Post-Installation Note: When the pages launch after the install completes, you might come across one of two screens:


– If you see a security warning, you can click Add Exception. The demo uses self-signed certificates, so this is why Firefox will notify you.


– If you see an authentication error, it means the session state was flushed by the browser. You can safely edit the address bar to:

“x” is the external IP of your instance. See the desktop wallpaper for your external IP.



Atos Apprenda Support