Update runner

Update your AWS runner.

Automatic updates

The runner automatically updates itself with new features, improvements, and security patches. No action required.

• Updates are non-disruptive to running environments
• Failed updates automatically roll back
• View current version at Settings → Runners
• Update activity is logged to CloudWatch

Update infrastructure

For significant infrastructure changes, manually update via CloudFormation:

1. Open your runner’s CloudFormation stack in AWS console

2. Click Update → Replace existing template

3. Enter the template URL:

   Standard:

   https://gitpod-flex-releases.s3.amazonaws.com/ec2/stable/gitpod-ec2-runner-enterprise-with-custom-network.json
   

   With private ECR:

   https://gitpod-flex-releases.s3.amazonaws.com/ec2/stable/gitpod-ec2-runner-enterprise-with-custom-network-private-ecr.template.json
   
   

4. Review parameters and complete the wizard

Update parameters

To change VPC, subnets, or other settings without updating the template:

1. Open your runner’s CloudFormation stack

2. Click Update → Use existing template

   

3. Adjust parameters and complete the wizard

Expanding availability zones

Availability is determined by your subnets, not the AZ parameter. Use the VPC Resource Map in AWS console to find subnets for your desired AZs.