CI Runnerscirunners.org
Runner profile · Cloud provider service

AWS CodeBuild-hosted runners

Answer in brief

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.

By the CI Runners editors · Updated

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

AttributeDetails
CI systemsGitHub Actions, GitLab CI, Buildkite
Operating systemsLinux, Windows
Architecturesx64, arm64
DeploymentCloud provider service
Where it can runAWS
IsolationEach 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 jobYes
HardwareOn-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 sizesOn-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
CachingCodeBuild 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 cachingYes
GPULinux 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.
ConcurrencyConcurrently running builds are capped by per-Region service quotas for each environment type, which AWS lists as adjustable
Job limitsMaximum build timeout of 2,160 minutes (36 hours)
Static IPsNot documented
SSH into running jobsNot documented
ObservabilityAWS CloudTrail integration is documented for runner projects.
SetupCreate 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 labelcodebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
PricingStandard 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 tier100 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
ComplianceNot documented
RegionsAll AWS Regions where CodeBuild is available
Open sourceNo
Company headquartersSeattle, 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

RunnerCI systemsRuns onDeploymentIsolationPriceLargest runnerDocker layer cacheGPUOpen sourceCompany HQ
AWS CodeBuild-hosted runnersGitHub Actions, GitLab CI, BuildkiteLinux, Windows, x64, arm64Your cloud accountFresh build environment$0.005/min72 vCPU / 144 GBYesYesNoUnited States
RunsOnGitHub ActionsLinux, Windows, x64, arm64Your cloud or hardwareEC2 instance€300/yr licence + AWS cost896 vCPUYesYesNoFrance
terraform-aws-github-runnerGitHub ActionsLinux, Windows, macOS, x64, arm64Self-hostedEC2 instanceFree software + your infrastructureSet by your infrastructureNot documentedYesYesNot documented
GitHub-hosted runnersGitHub ActionsLinux, macOS, Windows, x64, arm64Platform-hostedFresh VM$0.006/min96 vCPU / 384 GBNot documentedYesNoUnited States
GitLab-hosted runnersGitLab CILinux, macOS, Windows, x64, arm64Platform-hostedEphemeral VM$10 per 1,000 compute minutes32 vCPU / 128 GBNot documentedYesNoNot documented
Elastic CI Stack for AWSBuildkiteLinux, Windows, x64, arm64Self-hostedEC2 instanceFree software + your infrastructureSet by your infrastructureNot documentedNot documentedYesAustralia
Managed DevOps PoolsAzure PipelinesLinux, Windows, x64Platform-hostedAzure VM$15/month per parallel job + Azure VM costNot documentedNot documentedNot documentedNoUnited States
Actions Runner Controller (ARC)GitHub ActionsLinux, WindowsSelf-hostedKubernetes podFree software + your infrastructureSet by your infrastructureNot documentedNot documentedYesUnited 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

See all AWS CodeBuild-hosted runners alternatives →

Frequently asked questions

What is 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.
Which CI systems does AWS CodeBuild-hosted runners work with?
AWS CodeBuild-hosted runners runs jobs for GitHub Actions, GitLab CI and Buildkite, on Linux, Windows, x64 and arm64.
How does AWS CodeBuild-hosted runners isolate jobs?
AWS CodeBuild-hosted runners documents its isolation as: 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. Each job gets a fresh environment that is discarded afterwards.
Is AWS CodeBuild-hosted runners open source?
No, AWS CodeBuild-hosted runners is not open source. It does run in your own cloud account or on your own hardware.
How much does AWS CodeBuild-hosted runners cost?
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. Check the official pricing page for current rates.
How do you set up AWS CodeBuild-hosted runners?
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. An example label is codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}.
Does AWS CodeBuild-hosted runners have a 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.
Does AWS CodeBuild-hosted runners support ARM64 runners?
Yes, AWS CodeBuild-hosted runners documents arm64 runners (Linux and Windows).
Does AWS CodeBuild-hosted runners cache Docker layers?
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.
Does AWS CodeBuild-hosted runners offer GPU runners?
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.
How many jobs can run at once on AWS CodeBuild-hosted runners?
Concurrently running builds are capped by per-Region service quotas for each environment type, which AWS lists as adjustable.
Where do AWS CodeBuild-hosted runners runners run?
All AWS Regions where CodeBuild is available.
Where is Amazon Web Services, Inc. based?
Amazon Web Services, Inc., the organisation behind AWS CodeBuild-hosted runners, is headquartered in Seattle, Washington, United States. That is where the company is based, not where jobs run; for that, see the regions listed for AWS CodeBuild-hosted runners.
What are the alternatives to AWS CodeBuild-hosted runners?

Sources

  1. docs.aws.amazon.com/codebuild/latest/userguide/runners.html
  2. docs.aws.amazon.com/codebuild/latest/userguide/action-runner-overview.html
  3. docs.aws.amazon.com/codebuild/latest/userguide/action-runner-questions.html
  4. docs.aws.amazon.com/codebuild/latest/userguide/sample-github-action-runners-update-labels.html
  5. docs.aws.amazon.com/codebuild/latest/userguide/sample-github-action-runners-update-yaml.images.html
  6. docs.aws.amazon.com/codebuild/latest/userguide/gitlab-runner.html
  7. docs.aws.amazon.com/codebuild/latest/userguide/buildkite-runner.html
  8. docs.aws.amazon.com/codebuild/latest/userguide/buildkite-runner-about.html
  9. docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html
  10. docs.aws.amazon.com/codebuild/latest/userguide/fleets.html
  11. docs.aws.amazon.com/codebuild/latest/userguide/build-caching.html
  12. docs.aws.amazon.com/codebuild/latest/userguide/limits.html
  13. aws.amazon.com/codebuild/pricing/
  14. pricing.us-east-1.amazonaws.com/offers/v1.0/aws/CodeBuild/current/us-east-1/index.json
  15. aws.amazon.com/codebuild/faqs/
  16. aws.amazon.com/about-aws/whats-new/2024/04/aws-codebuild-managed-github-action-runners/
  17. aws.amazon.com/about-aws/whats-new/2024/09/aws-codebuild-managed-gitlab-runners/
  18. aws.amazon.com/about-aws/whats-new/2025/02/aws-codebuild-integrates-buildkite/
  19. 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/