AWS CodeBuild-hosted runners
AWS CodeBuild projects that start a single-use runner in your AWS account for each GitHub Actions, GitLab or Buildkite job. AWS’s managed way to run GitHub Actions, GitLab and Buildkite jobs on single-use CodeBuild compute in your own account, suited to teams already on AWS.
Overview
AWS CodeBuild-hosted runners let a CodeBuild project act as a self-hosted runner for GitHub Actions, GitLab CI/CD or Buildkite. A webhook on the project receives a job-queued event, and CodeBuild starts a build in your AWS account that registers a single-use runner, runs the job and is then discarded. Workflows target the project by name in runs-on (or GitLab tags, or Buildkite agents), with optional labels to override the image, instance size or fleet.
Because the runner is an ordinary CodeBuild build, jobs get what AWS describes as native integration with IAM, AWS Secrets Manager, AWS CloudTrail and Amazon VPC, and are billed at standard CodeBuild rates with no separate runner fee. Compute can be on-demand EC2, AWS Lambda or a reserved capacity fleet. Documented runner platforms are Amazon Linux, Ubuntu and Windows Server Core on x86-64 and Arm.
Notable
- AWS announced managed GitHub Actions self-hosted runners in CodeBuild on April 24, 2024
- AWS announced managed GitLab self-hosted runners in CodeBuild on September 17, 2024
- AWS announced native support for self-hosted Buildkite runners in CodeBuild on February 3, 2025
AWS CodeBuild-hosted runners specifications
| Attribute | Details |
|---|---|
| CI systems | GitHub Actions, GitLab CI, Buildkite |
| Operating systems | Linux, Windows |
| Architectures | x64, arm64 |
| Deployment | Cloud provider service |
| Where it can run | AWS |
| Isolation | Each job starts a CodeBuild build in a fresh environment that is discarded when it finishes; runner builds use CodeBuild containers or instances on Amazon EC2, or AWS Lambda compute |
| Fresh environment per job | Yes |
| Hardware | On-demand Amazon EC2 or AWS Lambda compute, or reserved capacity fleets, on x86-64 and Arm; AWS says runners can use its latest instance types, including ARM-based instances |
| Performance (vendor claim) | Not documented |
| Runner sizes | On-demand EC2: 2 vCPU / 4 GiB to 72 vCPU / 144 GiB on Linux x86-64, 2 vCPU / 4 GiB to 48 vCPU / 96 GiB on Arm, 4 vCPU / 8 GiB to 72 vCPU / 144 GiB on Windows. Lambda: 1 to 10 GiB of memory |
| Caching | CodeBuild projects can cache to Amazon S3 or use a local cache with source, Docker layer and custom modes. A Docker image server with a shared layer cache is billed separately per second. |
| Docker layer caching | Yes |
| GPU | Linux GPU compute types gpu_small (4 vCPU, 16 GiB) at $0.05 and gpu_large (32 vCPU, 255 GiB) at $0.30 per build minute in US East (N. Virginia); GPU models are not stated on the pages checked. |
| Concurrency | Concurrently running builds are capped by per-Region service quotas for each environment type, which AWS lists as adjustable |
| Job limits | Maximum build timeout of 2,160 minutes (36 hours) |
| Static IPs | Not documented |
| SSH into running jobs | Not documented |
| Observability | AWS CloudTrail integration is documented for runner projects. |
| Setup | Create a CodeBuild project with a webhook for WORKFLOW_JOB_QUEUED events (or the GitLab or Buildkite equivalent), then reference the project name in runs-on, tags or agents. Image, instance size and fleet can be overridden with labels. |
| Example label | codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }} |
| Pricing | Standard CodeBuild rates per build minute in US East (N. Virginia): Linux x86-64 small (2 vCPU) $0.005, medium $0.01, large $0.02; Arm small $0.0034, medium $0.007, large $0.015; Windows medium $0.018, large $0.036. EC2 builds are rounded up to the minute; Lambda compute is billed per second. Rates vary by Region. |
| Free tier | 100 build minutes per month on general1.small or arm1.small on-demand EC2, or 6,000 build seconds per month on 1 GB Lambda compute |
| Compliance | Not documented |
| Regions | All AWS Regions where CodeBuild is available |
| Open source | No |
| Company headquarters | Seattle, Washington, United States · More from the United States |
Facts from AWS CodeBuild-hosted runners’s public documentation, verified November 22, 2026. Performance figures are vendor claims.
Strengths and trade-offs
Reasons to choose it
- You want CI jobs to run inside your own AWS account with IAM roles and VPC access
- You use GitHub Actions, GitLab or Buildkite and want one runner service for all of them
- You want single-use runners without operating an autoscaler
- You need Arm, GPU or Windows compute billed at standard CodeBuild rates
Trade-offs
- macOS is not listed among the supported runner platforms, and on-demand fleets do not support macOS
- Build duration on EC2 compute is rounded up to the nearest minute
- Buildkite webhooks must be created manually; CloudFormation is not supported for them
- Secrets printed in the log are not masked by default
Good fit for: Teams on AWS that want GitHub Actions, GitLab or Buildkite jobs to run inside their own account with IAM and VPC access.
Use cases AWS CodeBuild-hosted runners fits
- ARM64 builds: Arm compute types and Amazon Linux aarch64 images are supported for runner builds.
- GPU jobs: Linux GPU compute types can be selected with the instance-size label.
- Your own cloud: Runner builds execute in your AWS account, with access to IAM, Secrets Manager, CloudTrail and Amazon VPC.
- GitLab CI runners: CodeBuild can host self-managed GitLab runners triggered by a GitLab webhook.
- Security and compliance: Each job runs in a fresh build environment that AWS says is isolated from other users and discarded on completion.
How AWS CodeBuild-hosted runners compares
| Runner | CI systems | Runs on | Deployment | Isolation | Price | Largest runner | Docker layer cache | GPU | Open source | Company HQ |
|---|---|---|---|---|---|---|---|---|---|---|
| AWS CodeBuild-hosted runners | GitHub Actions, GitLab CI, Buildkite | Linux, Windows, x64, arm64 | Your cloud account | Fresh build environment | $0.005/min | 72 vCPU / 144 GB | Yes | Yes | No | United States |
| RunsOn | GitHub Actions | Linux, Windows, x64, arm64 | Your cloud or hardware | EC2 instance | €300/yr licence + AWS cost | 896 vCPU | Yes | Yes | No | France |
| terraform-aws-github-runner | GitHub Actions | Linux, Windows, macOS, x64, arm64 | Self-hosted | EC2 instance | Free software + your infrastructure | Set by your infrastructure | Not documented | Yes | Yes | Not documented |
| GitHub-hosted runners | GitHub Actions | Linux, macOS, Windows, x64, arm64 | Platform-hosted | Fresh VM | $0.006/min | 96 vCPU / 384 GB | Not documented | Yes | No | United States |
| GitLab-hosted runners | GitLab CI | Linux, macOS, Windows, x64, arm64 | Platform-hosted | Ephemeral VM | $10 per 1,000 compute minutes | 32 vCPU / 128 GB | Not documented | Yes | No | Not documented |
| Elastic CI Stack for AWS | Buildkite | Linux, Windows, x64, arm64 | Self-hosted | EC2 instance | Free software + your infrastructure | Set by your infrastructure | Not documented | Not documented | Yes | Australia |
| Managed DevOps Pools | Azure Pipelines | Linux, Windows, x64 | Platform-hosted | Azure VM | $15/month per parallel job + Azure VM cost | Not documented | Not documented | Not documented | No | United States |
| Actions Runner Controller (ARC) | GitHub Actions | Linux, Windows | Self-hosted | Kubernetes pod | Free software + your infrastructure | Set by your infrastructure | Not documented | Not documented | Yes | United States |
Head-to-head: Actions Runner Controller (ARC) vs AWS CodeBuild-hosted runners · AWS CodeBuild-hosted runners vs Elastic CI Stack for AWS · AWS CodeBuild-hosted runners vs GitLab-hosted runners · AWS CodeBuild-hosted runners vs Managed DevOps Pools · AWS CodeBuild-hosted runners vs RunsOn · AWS CodeBuild-hosted runners vs terraform-aws-github-runner
Frequently asked questions
What is AWS CodeBuild-hosted runners?
Which CI systems does AWS CodeBuild-hosted runners work with?
How does AWS CodeBuild-hosted runners isolate jobs?
Is AWS CodeBuild-hosted runners open source?
How much does AWS CodeBuild-hosted runners cost?
How do you set up AWS CodeBuild-hosted runners?
codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}.Does AWS CodeBuild-hosted runners have a free tier?
Does AWS CodeBuild-hosted runners support ARM64 runners?
Does AWS CodeBuild-hosted runners cache Docker layers?
Does AWS CodeBuild-hosted runners offer GPU runners?
How many jobs can run at once on AWS CodeBuild-hosted runners?
Where do AWS CodeBuild-hosted runners runners run?
Where is Amazon Web Services, Inc. based?
What are the alternatives to AWS CodeBuild-hosted runners?
Sources
- docs.aws.amazon.com/codebuild/latest/userguide/runners.html
- docs.aws.amazon.com/codebuild/latest/userguide/action-runner-overview.html
- docs.aws.amazon.com/codebuild/latest/userguide/action-runner-questions.html
- docs.aws.amazon.com/codebuild/latest/userguide/sample-github-action-runners-update-labels.html
- docs.aws.amazon.com/codebuild/latest/userguide/sample-github-action-runners-update-yaml.images.html
- docs.aws.amazon.com/codebuild/latest/userguide/gitlab-runner.html
- docs.aws.amazon.com/codebuild/latest/userguide/buildkite-runner.html
- docs.aws.amazon.com/codebuild/latest/userguide/buildkite-runner-about.html
- docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html
- docs.aws.amazon.com/codebuild/latest/userguide/fleets.html
- docs.aws.amazon.com/codebuild/latest/userguide/build-caching.html
- docs.aws.amazon.com/codebuild/latest/userguide/limits.html
- aws.amazon.com/codebuild/pricing/
- pricing.us-east-1.amazonaws.com/offers/v1.0/aws/CodeBuild/current/us-east-1/index.json
- aws.amazon.com/codebuild/faqs/
- aws.amazon.com/about-aws/whats-new/2024/04/aws-codebuild-managed-github-action-runners/
- aws.amazon.com/about-aws/whats-new/2024/09/aws-codebuild-managed-gitlab-runners/
- aws.amazon.com/about-aws/whats-new/2025/02/aws-codebuild-integrates-buildkite/
- aws.amazon.com/privacy/
Check before you rely on it. Products change quickly, and this page reflects public documentation as of November 22, 2026. Confirm anything that matters in the provider’s own documentation.
Cite this page
CI Runners. (2026). AWS CodeBuild-hosted runners. cirunners.org. Last reviewed November 22, 2026. https://cirunners.org/runners/aws-codebuild-runners/