Documentation
In-depth guides for every step in the research journey, from finding and managing data to pipelining with workflows to interactive analysis (Jupyter notebook, RStudio or Galaxy).
Account and billing
- Overview: Terra costs and billing (GCP)
- Overview: Setting up billing in Terra
- How to set up billing in Terra
- How to change the Google Cloud Billing account of a Terra Billing project
- How to add/remove Google Cloud Billing account users
- How to disable billing in Terra
- See all 9 articles
Managing Access/Billing
- Best practices for sharing and protecting data resources
- Sharing data and tools with workspace access controls
- Managing access to shared data and tools with groups
- Best practices for managing shared funding
- How to manage shared funding (team workspaces)
- How to manage shared funding (team billing projects)
- See all 9 articles
Managing Cloud costs
- Overview: Controlling Cloud costs on Terra
- Displaying Google Cloud costs in Terra
- Workspace multi-region bucket migration
- How to set up spend reporting in Terra (GCP)
- Google egress pricing changes
- Controlling Cloud costs - sample use cases
- See all 15 articles
Workspaces
- Working with workspaces
- Curated template and tutorial workspaces
- How to clone your own workspace
- Build a workspace using data, showcase, and tools Library resources
- When workspace creation fails: Google project quotas
- Collaborate in a shared workspace
- See all 11 articles
Data
- Overview: Interoperable data (GA4GH DRS URIs)
- Access controlled data files by linking your NIH account in Terra
- How to access controlled data on external servers (i.e., Gen3)
- How to access data with DRS URIs
- See all 17 articles
Workflows
- Selecting the root entity type
- Writing workflow outputs to the data table
- Default runtime attributes for workflow submissions
- Workflow setup: VM and other options
- See all 17 articles
Interactive Analysis
- Cloud Environment FAQs
- Using the terminal and interactive analysis shell in Terra
- Overview: Cloud environment storage (detachable persistent disks)
- How to set up persistent disk storage for your analysis app
- See all 11 articles
Working with Containers (Docker)
- Docker/container overview
- Docker tutorial: Custom cloud environments for Jupyter Notebooks
- How to install Docker and test that it works
- How to run GATK in a Docker container
- Creating safe and secure custom Docker images
- Make a Docker (container) image the easy way: using a base image
- See all 9 articles
Troubleshooting
Advanced resources
- Supplemental information for Vertex AI workshop
- Accessing Google Cloud features that are not (yet!) available in Terra
- Best practices for source control on Terra
Legal and Compliance
- Terra security posture
- List of third-party tools
- Security logout for clinical researchers
- Government-owned websites and datasets
- Community Resource Datasets within Terra
- Terra Data Processing Addendum
Transitioning to Terra from FireCloud
- The most Terra-fic features for FireCloud veterans
- FireCloud and Terra - a side-by-side comparison
- How to get submission status and access error logs in Terra versus FireCloud
Deprecated articles
- Data Tables Quickstart Part 1 - Intro to data tables
- Data Tables Quickstart Part 2 - Making a data table from scratch
- Data Tables Quickstart Part 3: Understanding sets of data
- Data Tables Quickstart Part 4: Sets again! WDLS that take sets (arrays) as inputs
- Workflows Quickstart Part 1 - Run pre-configured workflow
- Workflows Quickstart Part 2 - Configure workflow to run on data in a table
- See all 11 articles