Learn how cloning a workspace makes a completely independent copy of the workspace under your own Billing project. Since you are the owner and sole user (until you choose to "share" your copy with someone else), you can experiment with code and data in your copy without running the risk of affecting a group workspace.
For information about collaborating in a single workspace, see How to share a workspace.
Step-by-step guide to cloning a workspace
Cloning is useful if you want to run computations in a workspace where you only have "read access." For example, cloning a Featured Workspace that covers the research tasks you want to do, is one way to jump into using Terra without writing your own scripts or notebooks.
See the video to learn how to clone a workspace in Terra
Step 1. Locate the three vertical dots icon
-
From within the workspace
Click on the three vertical dots on the top right of your workspace Dashboard page.
-
From the Workspaces page
1.1. To access the full list of Terra workspaces available to you, click on View Workspaces from the Terra homepage app.terra.bio.
1.2. Choose from your workspaces, new and interesting, featured, or public workspaces (in separate tabs).
1.3. Click on the three vertical dots at the far right of the workspace to clone.
Step 2. Complete the clone form
2.1. In the popup menu, choose Clone.
2.2. Type in your new workspace name, choose a Billing project, and Workspace bucket location. Enter an Authorization Domain (if needed).
More details on these options
- Note sure what works[ace storage location to use?
See Customizing where your data are stored and analyzed, or US Multiregional versus Regional bucket tradeoffs). - Not sure if you need an AD?
See Managing data privacy and access with Authorization Domains.
2.3. Click the Clone workspace button at the bottom of the form.
You should see the newly cloned workspace in the "My Workspaces" section of the Workspaces page immediately.
Troubleshooting tip
If you get an error message that includes the phrase "Precondition failed" (see screenshot below), you may have exceeded your Google project quota. To learn more about Google project quotas and how to request more, see When workspace creation fails: Google project quotas.
