Skip to main content

​
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:
Templates from January 2025 or earlier have SSH port changes. Before upgrading, stop and discard existing environments, or add port 22 to your security group (in addition to port 29222).
  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
    AWS CloudFormation Update stack dialog with Replace existing template option selected
  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
    AWS CloudFormation Update stack dialog with Use existing template option selected
  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.
AWS VPC Resource Map showing subnets and availability zones in your VPC