> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GCP runners

<Note>Available on the Enterprise plan. [Contact sales](https://ona.com/contact/sales) to learn more.</Note>

GCP Runners deploy Ona's runner infrastructure inside your own Google Cloud VPC. Development environments run as Compute Engine instances in your project. Source code and credentials never leave your infrastructure.

<img src="https://mintcdn.com/gitpod-13c83c2b/x2ZR1GQ5eyh1CR6Q/images/docs/flex/runners/gcp-runner.png?fit=max&auto=format&n=x2ZR1GQ5eyh1CR6Q&q=85&s=f73c7353c9ac89ffd4da1719a59b79fb" alt="Architecture diagram showing GCP Runner components including runner service, load balancer, and environment VMs in your VPC" width="3325" height="2410" data-path="images/docs/flex/runners/gcp-runner.png" />

## Architecture

A GCP Runner consists of:

* **Runner orchestrator**: a containerized service running on Compute Engine that manages environment lifecycle
* **Environment VMs**: Compute Engine instances automatically sized based on your environment class configuration
* **Load balancer**: routes traffic to environments, available as [external or internal](/ona/runners/gcp/reference-architectures)
* **Supporting services**: Memorystore Redis for state, Cloud Storage for build cache, Artifact Registry for container images

## Getting started

The runner is deployed using a [Terraform module](https://registry.terraform.io/modules/gitpod-io/ona-runner/google/latest) that provisions and configures all components. The [Setup guide](/ona/runners/gcp/setup) walks you through the process step by step, from creating the runner in the Ona dashboard to verifying it's online.

Before deploying, you may want to review the [reference architectures](/ona/runners/gcp/reference-architectures) to choose between external and internal load balancer modes based on your network requirements.

|                                                                      |                                                                                    |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Setup](/ona/runners/gcp/setup)                                      | Step-by-step deployment with Terraform                                             |
| [Reference architectures](/ona/runners/gcp/reference-architectures)  | External vs internal load balancer modes, networking, and certificate requirements |
| [Access requirements](/ona/runners/gcp/detailed-access-requirements) | IAM permissions, network connectivity, GCP APIs, and image access                  |
| [Private GAR images](/ona/runners/gcp/private-gar-images)            | Use private Google Artifact Registry images in Dev Containers                      |
| [Costs & budgeting](/ona/runners/gcp/gcp-runner-costs)               | Infrastructure costs and optimization strategies                                   |
| [Updating a runner](/ona/runners/gcp/update-runner)                  | Terraform infrastructure upgrades and release notifications                        |
| [Warm pools](/ona/projects/warm-pools)                               | Pre-initialized instances for near-instant environment startup                     |
| [Alerts & dashboards](/ona/runners/gcp/alerts-and-dashboards)        | Pre-built Grafana alerts and monitoring dashboards                                 |
| [Troubleshooting](/ona/runners/gcp/troubleshooting-runners)          | Common problems and diagnostic steps                                               |