# 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.&#x20;

\[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 %}
