# Run GOAT

What an install is and who looks after it.

This guide is for the people who install GOAT and look after it: cloud engineers and administrators at a company that runs GOAT. It covers what an install is, what it creates in your Google Cloud project, and the tasks of running it.

## What an install is

An install is one copy of GOAT in one of your Google Cloud projects. Everything it needs runs in that project, and you pay Google directly for what it uses. There is no GOAT-hosted service in between, and an install does not update itself or report back to anyone.

Each install has its own address, such as `https://analytics.example.com`, its own operators, its own datasets and dashboards, and its own customers.

## What it creates in your project

| Part | What it is for |
|---|---|
| Cloud Run service | Runs GOAT: the app, the API, and the embed script. One instance stays warm. |
| Firestore database | Holds what operators build: datasets' settings, collections, charts, dashboards, tenants, and access. |
| BigQuery dataset | Holds GOAT's managed copies of your data. |
| Cloud Storage bucket | Holds the files operators upload. |
| Identity Platform | Signs in operators, by password with an optional second factor, or with Google. |
| Secret Manager secret | Holds the keys that sign viewer tokens. |
| A second BigQuery dataset and a log sink | Keep a record of each query, for usage and cost figures. |
| A service account | The identity GOAT runs as, with only the access listed in [Architecture on Google Cloud](/under-the-hood/architecture). |

GOAT gets no access to your own data when it is installed. You grant it, dataset by dataset and bucket by bucket. See [Give GOAT access to your data](data-access.md).

## The tasks

| Task | Page |
|---|---|
| Install GOAT | [Install GOAT](install.md) |
| Decide who signs in to build | [Operators and sign-in](operators-and-sign-in.md) |
| Give backends their API keys | [API keys](api-keys.md) |
| Let GOAT read your data | [Give GOAT access to your data](data-access.md) |
| Know and cap what it costs | [Costs](costs.md) |
| Take a new release | [Upgrades](upgrades.md) |

For how the parts work together, see [Under the hood](/under-the-hood).
