# Transfer Data from JGI

{% hint style="danger" %}

### **The first version of the DTS has been implemented in a beta state and there may be bugs. If you have trouble with transfers, please contact us at <engage@kbase.us>.**

Currently, the DTS only supports **isolate genomes which were sequenced by JGI**.
{% endhint %}

### **Before transferring data from JGI to KBase, you must:**

* [Get a JGI account](https://signon.jgi.doe.gov/signon) and link it to ORCID
* [Get a KBase account](http://kbase.us/sign-up-for-a-kbase-account/) and link it to ORCID (see the section account linking instructions [here](https://docs.kbase.us/manage-account/link-accounts) for help)
* [Use either Chrome, Firefox, or Safari browser](https://docs.kbase.us/getting-started/browsers)

{% embed url="<https://youtu.be/4CBBV-GlLB8?si=_zLCrNkx2Wi096x9>" %}
Tutorial on Data Transfer Service
{% endembed %}

### Selecting data

JGI lets users select data from the [JGI Genome Portal's](https://img.jgi.doe.gov/) sequencing projects and make them transferable to KBase, all in a few simple steps.&#x20;

The DTS operates as a push from IMG to KBase. You can find genome data to move to KBase using the normal IMG/MER Data Portal. Once you have a selction of genomes to push, add them to your cart.

{% hint style="info" %}
For more on finding JGI data, see their [series of webinar tutorials](https://mgm.jgi.doe.gov/img-webinar-series/).
{% endhint %}

### Transferring Data from JGI to KBase

When you have selected your genome(s) of interest from IMG, you can access the data through the Genome Cart.&#x20;

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2Fbjnq1zLnifubtRxB5kiP%2FScreenshot%202025-10-22%20at%2011.39.02%E2%80%AFAM.png?alt=media&#x26;token=ef07b6cf-3eb3-4bbd-912e-3304bd41835f" alt=""><figcaption></figcaption></figure>

Select the genomes you want to transfer to KBase using the checkboxes in the IMG Genome Cart. When you have selected the genomes, go to the "Upload & Export & Save" tab.&#x20;

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2FisZ8PpckGWnpLR3lRSux%2FScreenshot%202025-10-22%20at%2011.39.38%E2%80%AFAM.png?alt=media&#x26;token=65f378a7-0367-44f9-b8d1-31d41fb10b7b" alt=""><figcaption></figcaption></figure>

Provide a name and description for the transfer job, then click "Push to KBase" and it will begin the transfer.&#x20;

{% hint style="warning" %}
Some JGI data is on tape storage and not immediately accessible. If you choose archived genomes there may be a significant delay before the files are transferred.
{% endhint %}

When the transfer is complete you will get a confirmation that the files have successfully transferred to KBase Staging Area.&#x20;

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2FfMamiU2KnnSwFGgyH34A%2FScreenshot%202025-10-22%20at%2011.39.48%E2%80%AFAM.png?alt=media&#x26;token=1d6a1641-3887-426a-9e6f-89345b276dc6" alt=""><figcaption></figcaption></figure>

To view the status of your transfer jobs, you can either click the link to "job status" in the confirmation, or go to "My Jobs" under the "My IMG" dropdown.

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2FDNejplmmUDEghdvNQeYY%2FScreenshot%202025-10-29%20at%2011.02.47%E2%80%AFAM.png?alt=media&#x26;token=3bcd8966-332e-4dc2-aa3f-43af3e268c4b" alt=""><figcaption></figcaption></figure>

### Importing to KBase

Open the Narrative where you want to import the data. Each transfer job that successfully moves files into KBase will have a folder with a name starting with `dts-`. Navigate into the folder you want to import.&#x20;

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2FYDmgtW9JTSPG1QnZdSYu%2FScreenshot%202025-10-22%20at%203.26.05%E2%80%AFPM.png?alt=media&#x26;token=c24b5989-1b94-4006-a2ac-ec182f3a598e" alt=""><figcaption></figcaption></figure>

The top level will contain a file `manifest.json` and a folder `img`, if the transfer was successful. You can examine the contents of `img` to verify you have all the files you wish to import. The file `manifest.json` is formatted to be usable by the staging service for bulk import. Choose the type "Data Transfer Service Manifest" from the "Import As" dropdown, ensure the file is checked, and click "Import Selected."

<figure><img src="https://596298931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrEs-tqcRLeDlhbWQs-%2Fuploads%2FX7DMdFSxClrIqTIIQvwI%2FScreenshot%202025-10-22%20at%203.26.17%E2%80%AFPM.png?alt=media&#x26;token=c12ace1d-4159-46c6-a775-180158383861" alt=""><figcaption></figcaption></figure>

The staging service will read the manifest and create a bulk import cell. From here, imports and data management proceed as normally. See [#bulk-import-guide](https://docs.kbase.us/upload-download-guide/uploads#bulk-import-guide "mention") for more information.