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 register for a Terra account
- Setting up a Google account with a non-Google email
- How to set up billing in Terra
- Set up billing with $300 Google credits to explore Terra
- How to change the Google Cloud Billing account of a Terra Billing project
- How to add/remove GCP Billing account users
- See all 9 articles
Managing Access
- Reader, writer or owner? Workspace access controls
- Managing shared resources with groups and permissions
- Best practices for sharing and protecting data resources
- Best practices for managing shared team resources
- Linking authorization/accessing controlled data on external servers
- Accessing GCP features that are not in the Terra UI
- See all 7 articles
Managing Cloud costs
- Understanding Terra costs and billing
- Understanding and controlling Cloud costs
- Controlling Cloud costs - sample use cases
- Where to view your cloud costs in Terra
- Terra expenses and breaking down a Google bill
- How to set up and use GCP budget alerts
- See all 7 articles
Workspaces
- Working with workspaces
- Curated template and tutorial workspaces
- How to clone a workspace
- How to share a workspace
- Documentation best practices (dashboards and notebooks)
- How to cite Terra
- See all 7 articles
Data
- Best practices for accessing external resources (external buckets, GCP VMs, machine-learning tools)
- Moving data to/from a Google bucket
- Moving data to/from the Cloud Environment detachable Persistent Disk
- Customizing where your data are stored and analyzed
- See all 14 articles
Workflows
- How does pipeline versioning work?
- Updating workflows to the latest version
- Data Model: How to process readgroup-level files
- Call caching: How it works and when to use it
- See all 9 articles
Cloud Environments Analysis
- Terra's Jupyter Notebooks environment Part II: Key operations
- Terra's Jupyter Notebooks environment Part III: Best Practices
- Using a startup script to launch a pre-configured cloud environment
- "Edit" and "Playground" Notebook Modes
- See all 12 articles
Working with Containers (Docker)
- Docker/container overview
- Docker tutorial: Custom cloud environments for Jupyter notebooks
- Install Docker and test that it works
- 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
- Expired Google Billing Account trial
- Google Cloud Billing account isn't showing up or has an error message
- Google Cloud Billing account does not appear in the billing management screen
- "resource has been exhausted" error
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)