Documentation

This page should help you get started with setting up and configuring Cloud Control.

Authentication

To get Cloud Control up and running you're going to need a credentials for an AWS account. This set-up is only required for the first time you use this app. The credentials will be safely stored in your MacOS Keychain.

This guide will help you create a user, give it limited permissions, and get your access and secret keys so cloud Control can use them.

First, go to your aws console and select the IAM service from the seach bar. Click on "Users" and select "Add User."

This user will be the Cloud Control app user. Feel free to name it something appropriate so you know later on who these credentials belong to:

Make sure you check "Programattic Access" and click "Next: Permissions."

On the next screen, select "Attach existing policies directly" and click "Create policy."

Select the JSON tab, and add the following in the text field:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:StartInstances",
                "ec2:StopInstances"
            ],
            "Resource": "*"
        }
    ]
}

The above policy allows the policy holder to list, start, and stop all EC2 Instances. If you want to limit the start/stop access to specific instances, add the ARN as an array instead of the "*."

Click "Review Policy" and add a name:

Next, go back to your user sign-up and attach your newly-created policy to this user:

Finish the user set-up. Add tags if you want, and create your user:

Finally, you're given your access and secret keys.

Copy these into the Cloud Control app to sign in.You will then be able to list, turn on, and turn off your EC2 instances from Cloud Control.

Settings

In the settings page, you can pick an AWS Region and filter which instances to display.

Filter Instances

This option allows you to show only instances that are tagged with "CloudControl::viewable = true."

AWS Region

From the drop-down, you can also switch to another region if your EC2 instances reside in another region.