Sunday, 18 May 2014

How to install the AWS Toolkit for Eclipse

This is another in a series of videos that I am producing for my YouTube channel HowDoYouDoStuff.

In this video, I am going to show you how to install the AWS Toolkit for Eclipse

You can read the transcript below.

HTML 5 Player


Hi guys. I'm Phil Stirpe.

In this video, I am going to show you how to install the AWS Toolkit for Eclipse.

The AWS Toolkit is an extension for Eclipse that makes it easier for developers to develop, debug, and deploy Java applications using Amazon Web Services.

You begin by visiting this page at

In fact there is nothing that you need to download from this page. You simply need to follow these short instructions.

The 1st stage is to get yourself into Eclipse.

Okay, I’m already in a workspace so I need to go to the Help Menu and select Install New Software.

This 1st box is where I need to put the URL. Rather than type it I’ll just copy it from the address bar.

Now I click the Add button and for a repository name I’m going to enter AWS.

I’ll just wait for it to build up the list.

Now rather than select the whole Toolkit, I’m going to select all except the SDK for Android as I had a problem installing this earlier.

I’ll accept the rest of these defaults and then click Next.

I review all of these items and then accept the license agreement before clicking Finish.

When I receive the security warning, I’ll just click OK to continue.

Once the AWS Toolkit has installed, I just need to restart Eclipse.

Following the restart, I am now prompted for an access key and a secret key.

These are credentials associated with an IAM user.

It is strongly recommended that you don’t use the credentials for your Root account. Instead you should create one or more IAM users.

Now I do have an IAM user created. In fact I created it in an earlier video and downloaded it credentials at that time.

Here is the file for the user called Frank, and here are his access key and secret key.

So I’ll just copy those values and switch back into Eclipse and paste them into this dialog.

We are now giving the AWS Toolkit the credentials for that IAM user named Frank. So whenever I work in Eclipse, I will be connected to Amazon web services as Frank and will be able to carry out any task that Frank has privileges for.

At the bottom of the screen we can see the open AWS Explorer window.

Rather than listing all of the available AWS services, the AWS Explorer is only showing the usual suspects. I.e. those services that the developer is most likely to interact with whilst working in Eclipse.

Perhaps I would want to access to S3 buckets, perhaps I would want to interact with EC2 and view instances?

Let me try to access S3. I’m told the AWS Explorer is unable to connect. However this is actually an access denied result.

The user named Frank does actually have permission to access S3. However this permission only relates to a particular bucket. Let me switch back to the AWS console to show you.

If I connect to the IAM console and find the user named Frank, you can see that he’s in a group called Developers.

If I check out the permissions for the Developers group, you can see that members have access to a bucket named qa-cookbooks.

Unfortunately the AWS Toolkit and therefore Eclipse cannot work at such a low level. If you want to access a service using the Toolkit menu going to have to have access to the service and not part of the service.

Now do have another group called S3Developers and if we examine it policy we can see that it has full access to the S3 service regardless of bucket. That will be more than enough for the AWS Toolkit.

So I’ll just add Frank to the S3Developers group.

Those changes should take effect straightaway and so I shouldn’t need to restart Eclipse.

Back in Eclipse, I’ll just refresh the AWS Explorer window.

As you can see, when the Toolkit attempted to reconnect to Amazon Web Services as Frank, it was granted these additional privileges and so the AWS Explorer was able to retrieve the bucket names.

However it would be able to access any other services for example EC2 to view instances and AMIs.

There you have it.

In this video, I have shown you how easy it is to install the AWS Toolkit for Eclipse.

Thanks for watching and please feel free to comment on my blog ( and Facebook page ( Perhaps you could suggest more video topics? Most of all, don't forget to subscribe to keep up with my videos as I release them.

Bye for now.

Flash Player

See you soon

Phil Stirpé
"I don't do average!"


  1. I get a lot of great information here and this is what I am searching for. Thank you for your sharing. I have bookmark this page for my future reference. Search aws jobs in hyderabad.