# Terra

Terra is a fully managed bioinformatics platform powered by Google Cloud Platform and Cromwell, with native support for WDL workflows. This guide demonstrates running the `02_download_collection_files.wdl` workflow in Terra, typically taking 5-10 minutes to complete.

## Prerequisites

Before starting, you'll need:

* [Google Account](https://accounts.google.com/signup)
* [Google Cloud Platform Account](https://cloud.google.com/?hl=en) (includes $300 free compute credit for 90-day trial)
* [Terra Account](https://terra.bio/resources/getting-started/)
* Optional: [git](https://git-scm.com/downloads)

Refer to Terra's [getting started](https://terra.bio/resources/getting-started/) guide for linking your GCP account and billing information.

## Initial Setup

### Get the Example Workflow

Download the worked examples repository containing `02_download_collection_files.wdl`:

#### Clone with Git

```shell
git clone https://github.com/DNAstack/dnastack-client-library-worked-examples.git
```

#### Or [Download](https://github.com/DNAstack/dnastack-client-library-worked-examples/archive/refs/heads/master.zip) and Unzip

Create a workspace that will house the workflow and output files. A cloud environment is not needed to run WDL workflows and can be skipped when prompted.

\[block:image] { "images": \[ { " image": \[ "<https://files.readme.io/e6eacb1-create-workspace1.gif>", "create-workspace1.gif", 1920, 969, "#000000" ], " border": true, "sizing": "full" } ] } \[/block]

### Importing a workflow

* Navigate to "Workflows" and select "Find a Workflow"
* Select "Broad Methods Repository" and log in with your Google account
* Choose "Create New Method"
* Upload `02_download_collection_files.wdl` or paste its contents
* Export to your Terra workspace using Blank Configuration

## Running a workflow

* Return to your workspace and select your workflow
* Choose "Run workflow with inputs defined by file paths"
* Click "Run Analysis" to begin execution
* Monitor progress in the "Job History" tab
* Access completed files in the "Data" tab under Files

{% hint style="warning" %}
Downloading files from Terra's Google Cloud Bucket may incur charges based on file size.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.omics.ai/products/analysis/integrations/terra.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.