Skip to content
Snippets Groups Projects
Chi Pak's avatar
6b7713d3

General BioHPC Setup

Instructions for logging into BioHPC/Web-Terminal and adding SSH key to your Git profile. The latter is required to clone Github repos from the dorsolab group.

Logging into BioHPC

There are two options for connecting to BioHPC.

If you're a Windows user and do not want to install the Linux subsystem, use the Web Visualization Terminal.
If you're a Linux/Mac user, you can connect to BioHPC via your local Terminal or using the Web Visualization Terminal.


Add SSH Key to Github Profile ----

In order to download Github repos from the dorsolab group, you must provide authentication in the form of a SSH key. The SSH key, which acts like a permanent password, is added to your Git profile.

Log into your Git profile on UTSW's Github page - upper right corner.

Portal Homepage

To login, use your Portal or BioHPC username/password (not your UTSW credentials).

Portal Login

Generate a SSH key, type

ssh-keygen -t rsa -C "your.email@example.com" -b 4096

where your.email@example.com should be replaced with your UTSW email. After typing in the above command, you will see a few prompts. Press Enter when it ask for the default directory and to save a passphrase - Press Enter at both passphrase prompts.

To view your SSH key, type

cat ~/.ssh/id_rsa.pub

You should see the following

ssh-rsa ... = your.email@example.com

where ... is a long alphanumeric key that spans multiple lines. Highlight the entire ssh key - starting from ssh and ending with .com - and copy it to the clipboard. Then navigate to the SSH Keys tab in your Profile Settings and paste your key in the Key section and give it a relevant Title.

Didn't think the abbreviated instructions provided enough details? Go to the full instructions to add SSH key to your Git profile.