# TTYD

## Starting a TTYD Instance

You can start a TTYD job the same way as you would any other job in the UI.

1. Select  Start Analysis in the top right corner in the project space.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdz0k9yCdkLOk1yziUEIHHU6P21prS3q5o0IFnrXp6RJSETaPUd4YEyQUB16yCO_nMIjjbjziQOp83SWLP7u_lKuqTokenJ3Ac7VVIl1tqyfX0a6U3WaIvG3His_IEmgXZ2g8BJL9XizMMLa3vNX_e_xUmgElictbzb5q4Fxg?key=87VlzzU1I_GithOtDP3HgQ" alt=""><figcaption></figcaption></figure>

2. Select the app called “ttyd”.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe7wyoBTImEDeeMk5uB16Cu86bxCSSunlnhnFHAk8dzCnwajl2dGKSVzu5qpivfjBr-w324aiyNFV35Zn-mIokeE8MNx4lEbwOptg3AuVn7NcRlmzraSwVkXSYWZ98D9UGYKI7hSHQWrIBAV9bbHppMQXXIW8Uu5UnDaDpu9A?key=87VlzzU1I_GithOtDP3HgQ" alt=""><figcaption></figcaption></figure>

3. &#x20;Select Next and then Start Analysis.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcp_xRg9vo6W5po-uhoHeLPaVxFmnCnWmMA72sSZ5xC0zlgv19hsOuCsvvEIdOE6qhp1f2OyhvuPO-YwCmYZqsgWMsi70_BZbvWozCazGjZoB-dsIvu-FtkkDNn4_u6iqGlz5LuJ4BCndwnWN5vRBDDj-pwLT4lIXWW1TzKcQ?key=87VlzzU1I_GithOtDP3HgQ" alt=""><figcaption></figcaption></figure>

4. As the last step before launching the tool, you can review and confirm various runtime settings. Click on Launch Analysis. The job will be launched and you will be redirected to the Monitor tab in a few seconds.<br>
5. In the Monitor tab, select the name of the ttyd job to view more details.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfRvBaMtO0ybol_I6cfx2JoWjjs6Ibf_MkB_Z-B1MKAr6Cy90ItOMhadsvZH1cSZlddXqXNcVY0dwy6Gp6gvyU8HCzohAyFSbBqcJvtipdkh0QO-lLVEPESFUd9nfnvcTWx7O9ZXDf0e6vGSPmV_wOPCpiQ4h4bUenNduv4?key=87VlzzU1I_GithOtDP3HgQ" alt=""><figcaption></figcaption></figure>

6. Once the state of the job switches to “Running”, you will be able to enter  the ttyd with the “Open Worker URL” link in the top heading of the details page. If the page to which you get redirected says “502 Bad Gateway”, the worker is not yet fully initialized. Close the page, give it a few more minutes and try to open the worker URL again.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcGNr-yFhE-gmkajpGDLB4mDmKYYQo161vsKJD249iv7_FULUbGFHT45w0IbN-rQrMm6hPNQVimt9Uf-deSSxQrf9-Q7TYskzd48T2_nm4pVSHij7Kqphfc7_AHW-qxf69PcWmlkQtZr2kEaJ7KKQoLYhk3hDMP7u1oCVA4GQ?key=87VlzzU1I_GithOtDP3HgQ" alt=""><figcaption></figcaption></figure>

7. This will open a terminal in your browser that will give you access to the files in the DNAnexus project in which the app is running by mounting it in a read-only mode in the /mnt/project directory of the worker execution environment.&#x20;
8. Once you are done with your work in ttyd, don’t forget to terminate the job by clicking the red button Terminate in the job’s details page.

### Resources

[Full Documentation](https://documentation.dnanexus.com/)

To create a support ticket if there are technical issues:

1. Go to the Help header (same section where Projects and Tools are) inside the platform
2. Select “Contact Support”
3. Fill in the Subject and Message to submit a support ticket.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.dnanexus.com/interactivecloudcomputing/ttyd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.