{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Import Dockstore apps to the CGC","type":"basic","slug":"run-dockstore-apps-on-the-cgc","excerpt":"","body":"This page will explain how you can use the CGC to import an app that is available on Dockstore. Dockstore is an open platform for sharing Docker-based apps described with the [Common Workflow Language](https://www.commonwl.org/) (CWL), [Workflow Description Language](http://www.openwdl.org/) (WDL) or [Nextflow](https://www.nextflow.io/), which enables bioinformaticians to share analytical tools that can be executed in a compliant execution environment, such as the CGC.\n\nThe CGC is integrated with Dockstore, which means that you can import an app from Dockstore to the CGC with a single click of a button. This process consists of two stages:\n\n* Navigating through Dockstore and selecting an app to launch on the CGC.\n* Completing the import process on the CGC and running the app.\n\nAs the CGC supports the Common Workflow Language, the CGC button is visible only for CWL apps on Dockstore. Also, please note that Dockstore is an external service and apps that are available on Dockstore are third-party apps. Therefore, Seven Bridges does not guarantee the performance of such apps on the CGC.\n\n### Finding an app on Dockstore\n\nThis step takes place on Dockstore.\n1. Navigate to [dockstore.org](https://dockstore.org) in your web browser.\n2. In the top navigation bar click **Search**. The search screen opens.\n3. In the **Search** box on the left, enter the desired keyword(s).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9921c7c-run-an-app-from-dockstore-on-the-cgc-1.png\",\n        \"run-an-app-from-dockstore-on-the-cgc-1.png\",\n        933,\n        735,\n        \"#2f3956\"\n      ]\n    }\n  ]\n}\n[/block]\n4. If necessary, use additional filtering options below the **Search** box to narrow down the search results.\n5. In the search results list, click the name of the desired app. App details page opens.\n6. (Optional) In the **Recent Versions** box on the right, select a different version of the app. Latest app version is selected by default.\n7. In the **Launch with** box click **CGC**. This takes you to the CGC.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bf4e638-run-an-app-from-dockstore-on-the-cgc-2.png\",\n        \"run-an-app-from-dockstore-on-the-cgc-2.png\",\n        1218,\n        767,\n        \"#e5e9eb\"\n      ]\n    }\n  ]\n}\n[/block]\n\n### Completing the import on the CGC\n\nThis step takes place on the CGC.\n\nAfter selecting **Launch with** > **CGC** on Dockstore, you are taken to the CGC and presented with the app import screen.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ff92e2b-run-an-app-from-dockstore-on-the-cgc-3.png\",\n        \"run-an-app-from-dockstore-on-the-cgc-3.png\",\n        773,\n        384,\n        \"#daf8f1\"\n      ]\n    }\n  ]\n}\n[/block]\n1. Select the project in which you want to run the app.\n2. (Optional) Change the app URL. This is the unique URL that identifies the app on the CGC and usually does not need to be changed unless there is already an app with the same URL in the project.\n3. Click **Import the app**. This takes you to the app details page inside the selected project.\n\nIf you want to make further edits to the app before running it, click **Edit** in the top-right corner. Otherwise, click **Run** to create a draft task, set task inputs and run the app on the CGC.","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5912eb36c0935b270003a9bc","user":"5767bc73bb15f40e00a28777","createdAt":"2017-05-10T10:28:06.581Z","githubsync":"","category":{"sync":{"isSync":false,"url":""},"pages":["5626a5d644c87f0d00fe6396","5626a5e4e2ce610d004e3dd8","5626a89ce2ce610d004e3dde","56429a87f49bfa0d002f54e0"],"title":"RUN AN ANALYSIS","slug":"run-an-analysis","order":21,"from_sync":false,"reference":false,"_id":"55faf96917b9d00d00969f48","project":"55faf11ba62ba1170021a9a7","__v":4,"createdAt":"2015-09-17T17:33:29.016Z","version":"55faf11ba62ba1170021a9aa"},"project":"55faf11ba62ba1170021a9a7","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f","5c222bed4bc358002f21459a","5c22412594a2a5005cc9e919","5c41ae1c33592700190a291e","5c8a525e2ba7b2003f9b153c","5cbf14d58c79c700ef2b502e","5db6f03a6e187c006f667fa4","5f894c7d3b0894006477ca01"],"_id":"55faf11ba62ba1170021a9aa","releaseDate":"2015-09-17T16:58:03.490Z","createdAt":"2015-09-17T16:58:03.490Z","project":"55faf11ba62ba1170021a9a7","__v":47},"__v":0,"parentDoc":null}

GET STARTED

TUTORIALS

ACCESS THE CGC

MANAGE AN ANALYSIS ENVIRONMENT

COLLABORATE SECURELY

DATASETS HUB

PUBLIC PROJECTS

BRING DATA TO THE CGC

SET METADATA ASSOCIATED WITH A PRIVATE FILE

SEARCH FILES

ADD FILES TO A PROJECT

ORGANIZE FILES

ARCHIVE FILES

FIND APPS

BRING YOUR TOOLS

DOCKER

DESCRIBE YOUR TOOL (LEGACY)

TOOL WRAPPING TIPS AND TRICKS

EDIT AN APP (LEGACY)

ARCHIVE APPS

RUN AN ANALYSIS

TASK EXECUTION

REVIEW A TASK

VIEW ANALYSIS RESULTS

INTERACTIVE ANALYSIS

DOWNLOAD RESULTS

DEVELOPER TOOLS

CONNECT CLOUD STORAGE

API Hub

API CLIENTS

SB Command Line Interface

API Reference

EDIT AN APP

BULK API ACTIONS

ASYNC BULK ACTIONS

DRS API

WES API

DATA CRUNCHER

SBFS (Beta)

SBFS Command Reference

Import Dockstore apps to the CGC

This page will explain how you can use the CGC to import an app that is available on Dockstore. Dockstore is an open platform for sharing Docker-based apps described with the [Common Workflow Language](https://www.commonwl.org/) (CWL), [Workflow Description Language](http://www.openwdl.org/) (WDL) or [Nextflow](https://www.nextflow.io/), which enables bioinformaticians to share analytical tools that can be executed in a compliant execution environment, such as the CGC. The CGC is integrated with Dockstore, which means that you can import an app from Dockstore to the CGC with a single click of a button. This process consists of two stages: * Navigating through Dockstore and selecting an app to launch on the CGC. * Completing the import process on the CGC and running the app. As the CGC supports the Common Workflow Language, the CGC button is visible only for CWL apps on Dockstore. Also, please note that Dockstore is an external service and apps that are available on Dockstore are third-party apps. Therefore, Seven Bridges does not guarantee the performance of such apps on the CGC. ### Finding an app on Dockstore This step takes place on Dockstore. 1. Navigate to [dockstore.org](https://dockstore.org) in your web browser. 2. In the top navigation bar click **Search**. The search screen opens. 3. In the **Search** box on the left, enter the desired keyword(s). [block:image] { "images": [ { "image": [ "https://files.readme.io/9921c7c-run-an-app-from-dockstore-on-the-cgc-1.png", "run-an-app-from-dockstore-on-the-cgc-1.png", 933, 735, "#2f3956" ] } ] } [/block] 4. If necessary, use additional filtering options below the **Search** box to narrow down the search results. 5. In the search results list, click the name of the desired app. App details page opens. 6. (Optional) In the **Recent Versions** box on the right, select a different version of the app. Latest app version is selected by default. 7. In the **Launch with** box click **CGC**. This takes you to the CGC. [block:image] { "images": [ { "image": [ "https://files.readme.io/bf4e638-run-an-app-from-dockstore-on-the-cgc-2.png", "run-an-app-from-dockstore-on-the-cgc-2.png", 1218, 767, "#e5e9eb" ] } ] } [/block] ### Completing the import on the CGC This step takes place on the CGC. After selecting **Launch with** > **CGC** on Dockstore, you are taken to the CGC and presented with the app import screen. [block:image] { "images": [ { "image": [ "https://files.readme.io/ff92e2b-run-an-app-from-dockstore-on-the-cgc-3.png", "run-an-app-from-dockstore-on-the-cgc-3.png", 773, 384, "#daf8f1" ] } ] } [/block] 1. Select the project in which you want to run the app. 2. (Optional) Change the app URL. This is the unique URL that identifies the app on the CGC and usually does not need to be changed unless there is already an app with the same URL in the project. 3. Click **Import the app**. This takes you to the app details page inside the selected project. If you want to make further edits to the app before running it, click **Edit** in the top-right corner. Otherwise, click **Run** to create a draft task, set task inputs and run the app on the CGC.