Setup Guide

We carfully crafted this guide helping you to deloy self-hosted runners on AWS with ease. In case you encounter any issues please schedule a setup session or send an e-mail. We are happy to help!

1. Create subscription

HyperEnv for GitHub Actions Runner is available on the AWS Marketplace. The following steps describe how to subscribe to HyperEnv for GitHub Actions Runner.

  1. Go to AWS Marketplace and click View purchase option. Step 1
  2. Read through the terms and click the Subscribe button at the bottom of the page. Step 2
  3. AWS Marketpace processes the request which might take a few minutes. Step 3
  4. Wait until the subscription is active and click Launch your software. Step 4
  5. Select AWS CloudFormation as launch method. Keep the latest version.
    Choose a CloudFormation template. We recommend to choose the Dedicate VPC with public subnets option. Alternatively, select Existing VPC to launch the runners into exsisting subnets, allowing you to connect with internal systems (e.g., RDS).
    Select the region where you want to deploy HyperEnv. Step 5
  6. Press the Launch with CloudFormation button. Step 6
  7. You are getting redirected to CloudFormation.

2. Launch with CloudFormation

We provide a CloudFormation template that spins up and configures all the releveant AWS resources - EC2 instances, security groups, an API gateway, Lambda functions, and many more - for you in an automated way.

  1. Step Create stack
    1. The AWS Marketplace populates all the configuration parameters for step 1. Proceed by clicking Nex.
    Step 7
  2. Step Specify stack details
    1. Set a name for the CloudFormation stack. We recommend hyperenv-github-actions.
    2. Continue with the required configuration parameters.
      1. VpcId (Bring Your Own VPC only) - The VPC used when launching EC2 instances to execute GitHub runners.
      2. SubnetIds (Bring Your Own VPC only) - The subnets used when launching EC2 instances to execute GitHub runners. Define at least two subnets with route to Internet or NAT Gateway.
      3. KeyPair - The key pair allowing you to establish a SSH connection with the EC2 instance executing the GitHub runner.
      Step 8
    3. Review the rest of the parameters and go with the defaults (recommended).
    4. Scroll to the bootom of the page and click the Next button.
  3. Step Configure stack options
    1. Keep the default and scroll to the bootom of the page.
    2. Step 9
    3. Select I acknowledge that AWS CloudFormation might create IAM resources. and press the Next button.
    4. Step 9
  4. Step Review
    1. Review your configuration and scroll down to the bottom of the page.
    2. Step 10
    3. Click the Submit button to create the stack.
    4. Step 10
  5. The stack status is CREATE_IN_PROGRESS. Reload the list of stacks from time to time and wait until the CloudFormation stack hyperenv-github-actions switches to CREATE_COMPLETE. Step 11
  6. Switch to the Outputs tab and search for the output named NextStepUrl and click the shown link. Step 12

By following the NextStepUrl you will be guided through the process of installing the GitHub app next.

Help needed?

Do you need any setting up HyperEnv for GitHub Actions Runner? We are happy to help!

Book setup session Send e-mail