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
- How to set up billing in Terra
- Setting up a Google account with a non-Google email
- Changing the Google Cloud Billing account of a Terra Billing project
- How to add/remove Google Cloud Billing account users
- How to disable billing
- How to delete a Terra Billing project (Swagger)
- See all 7 articles
Managing Access
- How to register a service account in Terra
- Sharing data and tools with workspace access controls
- Managing access to shared resources (data and tools)
- Best practices for sharing and protecting data resources
- Best practices for managing shared funding
- Linking authorization/accessing controlled data on external servers
- See all 8 articles
Managing Cloud costs
- Costs of selected featured workflows
- Frequently Asked Questions- Managing Cloud Costs
- Overview: Terra costs and billing
- Overview: Controlling Cloud costs on Terra
- Controlling Cloud costs - sample use cases
- How to view your cloud costs in Terra
- See all 11 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 10 articles
Data
- How to use the Data Uploader
- How to move data between local and workspace storage (Google bucket)
- How to transfer data between local storage and your Cloud Environment PD
- How to transfer data between your Cloud Environment PD and workspace storage
- See all 8 articles
Workflows
- What to expect when you submit a workflow
- Getting started with GATK workflows in the cloud FAQs
- Finding the workflow (method) you need (and its JSON) in the Methods Repository
- How to import a workflow and its parameter file from Dockstore into Terra
- See all 14 articles
Interactive Analysis
- Cloud Environment FAQs
- Analyses tab FAQs
- Using the terminal and interactive analysis shell in Terra
- Overview: Cloud environment storage (detachable persistent disks)
- See all 12 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
Legal and Compliance
- Terms of Service
- Terra security posture
- List of third-party tools
- Security logout for clinical researchers
- Government-owned websites and datasets (Last Revised Feb 5,2020)