Create and Set Your Amazon S3 API Credentials

3 min read

Currently the new backup system is BETA only.

To activate backups 2.0 head to your servers page and click on the name of the server you wish to activate it on.

Warning: This will disable Borg and purge all existing Borg backups from your system. You are responsible for ensuring you have existing backups in place. By enabling Backups v2 you accept full responsibility for this action and confirm you have alternative backups in place. Only enable if you agree to these conditions. Once enabled, this can not be disabled. Borg is going back to the Delta Quadrant.

Amazon Simple Storage Service (Amazon S3) is Amazon’s object storage service. It’s cheap and secure, and an excellent option for remote backups. This article will walk you through how to generate your S3 API keys and add them to your GridPane account.

NOTE: Currently, the IAM user requires all access. We’re looking into restricted access and we will update this article as the new backup system develops further.

Step 1. Sign in to the IAM console

Log in to your IAM console.

Once inside the console, choose Policies in the left navigation pane.

IAM_Management_Console_-Policy_Screen_.png

Step 2. Create an Amazon S3 Gridpane policy

In the Policies, panel click the blue Create policy at the top of the page.

On the following page you’ll need to add the “S3” service into the search bar and select it as the service you wish to create a policy for.

Then check the “All S3 Actions” checkbox.

Next click on resources and select All resources.

You can then click the Review policy button at the bottom of the page.

Next give your policy a name and a description and click the Create policy button. You’ll need to remember your policy name for the next step.

Step 3. Create a Key and Secret

Next, still in the IAM console, choose users from the left-hand navigation and then click on Add User on the following page.

Part 1

Here you need to give your new user a name and check the programmatic access checkbox.

Part 2

Select “Attach Existing Policy Option” and then search for the name of the policy you created in step 2.

Part 3

This is optional, feel free to skip it and click the “Next: Review” button.

Part 4

Here you can review your information, confirm it’s correct, and then click the Create User button.

Page 5

This next page contains your new Access Key ID and Secret access key for your user. These will NEVER be shown again so it’s important you note them down, or alternatively you can download these credentials as a CSV file.

Your credentials have now been created. Now it’s time to add them to your GridPane account.

Step 4. Add your Amazon S3 API credentials to GridPane

Back in your GridPane account, click through to your settings page:

And then through to the Backup Providers page and enter your API details.

Enter your details, select your provider from the dropdown, and then click the Create button.

You’re all set! To learn how to configure remote backups for your websites check out the following article for a full walk-through:

Remote Website Backups