Overview
AWS Runners allow you to deploy Gitpod’s runner infrastructure directly within your own AWS VPC, giving you complete control over your development environments while maintaining security and compliance requirements.
When you deploy an AWS Runner, development environments are created as EC2 instances that are automatically sized based on your environment class requirements. The runner orchestrator itself runs as an ECS service within a dedicated ECS cluster in your AWS account. The entire deployment is automated through CloudFormation templates that we provide, making setup straightforward while ensuring best practices for security and scalability.
Overview of Gitpod AWS runner architecture
Choose Your AWS Runner
Gitpod offers two AWS runner variants to meet different security and feature requirements. For information on runners generally, see Self-Hosted Runners.
Standard Runner
Quick & Easy: 30-minute setup with CloudFormation template. Secure connectivity through Gitpod’s central gateway eliminates complex networking configuration.
Enterprise Runner
Advanced Features: AI agent integration, direct connectivity with your own domain/certificates, and enhanced security controls. Enterprise tier only.