Installing Saturn

Sign up for Saturn in the AWS marketplace, and deploy Saturn into your AWS account.

Overview

Saturn has a two-tier architecture. You will sign up in the Saturn Manager, which is where you can configure and install Saturn. Once Saturn is installed, you never come back to the Manager. You will add users directly in your Saturn instance. Saturn runs entirely in your AWS account in it’s own EKS cluster and VPC so your code and data stay in your account.

Sign up for Saturn

Please Sign up for Saturn in the Saturn Manager. Once installed, Your saturn installation will be hosted at “app.{orgname}.saturnenterprise.io”, so the company name will be converted into a valid DNS name.

The manager will take you to the AWS marketplace, where you can subscribe for Saturn.

Creating the Installation IAM Role

Saturn needs an IAM role to install the necessary components. We can make the role for you, or you can do it yourself.

Let Saturn Create the IAM Role

Creating Access Keys

If you already have access keys you can skip this section.

Sign in to the AWS Management Console. In the navigation bar on the upper right, choose your account name or number and then choose My Security Credentials. In general, it’s better to use IAM users, but If you are signed in as the AWS root user, expand the Access keys (access key ID and secret access key) section and click Create New Access Key

If you are signed in as an IAM user, select AWS IAM credentials and click Create Access Key.

When prompted, download the csv file. This is your only opportunity to save your secret access key. After the installation is complete we won’t need these credentials anymore. You can delete them.

Create the Installation IAM Role

Go back to the Saturn installer.

Paste your Access Key ID and Secret Access Key into the form and click Next. We will use the keys to create a role. For security reasons, we will not save the keys.

Configure and Install Saturn

After you create the role and record the ARN, you’re ready to configure your deployment. Choose an “Organization Name”, your “Work Email”, your desired AWS region, and the ARN for the IAM role from the previous step to continue.

Deploy Saturn

Click “Deploy” and Saturn will install into your AWS account. Installation takes about 15 minutes. When it is complete, you will receive an e-mail instructing you to reset your password for the “admin” account on your new Saturn deployment.

Logging in to your Saturn installation

After installing Saturn, you should receive a password reset email, which you can use to reset the password for the admin account.

If that link has expired, you can generate a new one at this URL. Make sure that you replace {org-name} with the name of the Organization you setup when you subscribed to Saturn.

https://app.{org-name}.saturnenterprise.io/auth/resetemail Again: Make sure that you replace {org-name} with the name of the Organization you setup when you subscribed to Saturn.

Type in admin as the username. You should get a new password reset link via email in a few minutes.


Creating the Installation Role Yourself

Saturn needs an IAM role to install the necessary components. We can make the role for you, or you can do it yourself. This section details how to create the role yourself.