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)
- How to set up a Terra account with a non-Google email
- 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
- See all 10 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 10 articles
Managing Cloud costs
- Overview: Controlling Cloud costs on Terra
- Displaying Google Cloud costs in Terra
- How to set up spend reporting in Terra
- Google egress pricing changes
- Controlling Cloud costs - sample use cases
- How to view your cloud costs in Terra
- See all 14 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
- Managing data with tables
- How to use the Data Uploader
- How to move data to/from a Google bucket (workspace or external)
- How to transfer data between local storage and your Cloud Environment PD
- See all 11 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
- Are resource quotas slowing your analysis down?
- Web Portal: Endless spinner / "Loading auth..." message
- Web Portal: Internal Server Error or Gateway Timeout
Advanced resources
- 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
Archived articles
- Data Tables Quickstart Part 1 - Intro to data tables
- Analyses tab FAQs
- 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
- See all 11 articles