Linking a Cloud Account to the Supergiant 2.0.0 Control

Supergiant Control is the “Mothership” or central hub of the Supergiant toolkit that allows managing cloud accounts, K8s cluster provisioning, and lifecycle of clusters on your infrastructure, as well as the deployment of applications via HELM.  Its deployment and configuration workflows will help you to get up and running with Kubernetes faster. In this tutorial, you’ll learn how to link your first cloud account to Supergiant 2.0.0 Control tool. By the end of this tutorial, you’ll have a working cloud account that can be used to deploy your first Kubernetes cluster with the SG Control. 


To complete examples in this tutorial you’ll need the following prerequisites.

  • A running Supergiant 2.0.0 Control tool. See our SG control installation guide to learn more.
  • An AWS or DigitalOcean cloud account with access to security credentials.

Step #1: Log in to Your SG Control Dashboard

Assuming you have Supergiant Control installed and running on your local system on the default port, open your browser and go to   localhost:8080 . From there, log in to the Dashboard using login and password generated during the SG Control installation.

Supergiant Control: Login 

The first screen you’ll see after logging in is Home Page that says “Welcome to Supergiant.” Since it’s a fresh install, you’ll be asked to link a new cloud account. A cloud account may be thought of as a set of permissions that allow Supergiant to deploy clusters on your behalf on those clouds (CSPs). At this moment, Supergiant supports DigitalOcean and AWS cloud accounts. New cloud providers such as GCE, Packet, OpenStack, etc. will be also added in the near future.

Supergiant Control: home

Step #2 Configuring a Cloud Account

Let’s go ahead with linking a cloud account. Click on the “Link an Account” button you see in the image above and choose your cloud provider (AWS or DigitalOcean). Alternatively, you can click on the “Cloud Accounts” link in the Admin Drop-down menu at the top right of the Home Page, and this will have the same effect.

You’ll see the New Cloud Account dialogue where you can select a Cloud Account type you want to link: DO or AWS.

DigitalOcean Cloud Account

To link an DO cloud account, you’ll have to fill in the following fields:

  • Cloud Account Name — an arbitrary name for your cloud account.
  • Access Token — The DO key available in your DO account details.
  • Public Key — The fingerprint of the public key used on your DO account.

Supergiant cloud account: Digital Ocean

Note: For more information about getting Access Tokens and Public Keys from DigitalOcean, see their official documentation.

AWS Cloud Account

An AWS cloud account configuration is a little bit different from the DigitalOcean.

Supergiant: AWS cloud account

If you want to add an AWS cloud account, you will be required to enter your:

  • Cloud Account Name — This can be anything you choose, and does not have to be the same as the actual cloud account’s name.
  • Access Key — The access key used with this AWS account.
  • Secret — The secret key used with this AWS account.

Note: For more information about getting Access Keys and Secret Keys from AWS, see their official documentation.

Step #3 Adding a Cloud Account

After you’ve entered all the details, click the “Submit” button.  Supergiant will check and determine if the credentials you typed are accurate and will then create a cloud account. You’ll be able to see and manage the account details under Admin Dropdown -> Cloud Accounts. 

Step #4 Managing Cloud Accounts

Supergiant Control offers a simple interface for managing your cloud accounts. It allows adding new and deleting existing cloud accounts. The easiest way to open the Cloud Accounts page is from the Admin Dropdown -> Cloud Accounts at the top right corner of the Home page.

Supergiant: cloud accounts list

Here you can easily edit, delete, or add new cloud accounts by following simple steps.


That’s it! You’ve learned how to link your first cloud account to the new Supergiant 2.0.0 Control tool. Once you have a cloud account added, you are now able to provision your first Kubernetes cluster with Supergiant Control. If you want to continue your Supergiant 2.0.0 journey, read the next tutorial about provisioning a K8s cluster with Supergiant.

What’s Next?

Learn more about Supergiant toolkit using the following resources:

Getting started with the Supergiant Toolkit

Supergiant Control on GitHub

Supergiant Capacity on GitHub

Supergiant Analyze on GitHub

Supergiant 2.0.0 Documentation


Subscribe to our newsletter