This lesson is in the early stages of development (Alpha version)

HPC Carpentry part 1 - Using the shell: Setup

There are a few steps to setup for the workshop. We strongly recommedn that you complete these before the worksop starts. If you run into problems, please contact the workshop leader at the e-mail address on the home page. We will also provide installation and setup help at the workshop if required, but you will get more out of the training if you can complete them ahead of time.

There are three steps to the setup:

  1. Ensure your laptop has the bash shell installed
  2. Ensure that your bash shell is equipped with an SSH client
  3. Setup an account on the HPC system, Cirrus, that we will be using for the workshop

These steps are described in more detail below.

bash Shell

To participate in an HPC Carpentry workshop, you will need access to a bash shell. Please make sure to install everything (or at least to download the installers) before the start of your workshop. In addition, you will need an up-to-date web browser.

We maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki page.


  1. Download the Git for Windows installer
  2. Run the installer and follow the steps below: a. Click on “Next”. b. Click on “Next”. c. Keep “Use Git from the Windows Command Prompt” selected and click on “Next”. If you forgot to do this programs that you need for the workshop will not work properly. If this happens rerun the installer and select the appropriate option. dlick on “Next”. d. Keep “Checkout Windows-style, commit Unix-style line endings” selected and click on “Next”. e. Keep “Use Windows’ default console window” selected and click on “Next”. f. Click on “Install”. g. Click on “Finish”.
  3. If your “HOME” environment variable is not set (or you don’t know what this is): a. Open command prompt (Open Start Menu then type cmd and press [Enter]) b. Type the following line into the command prompt window exactly as shown: setx HOME "%USERPROFILE% c. Press [Enter], you should see SUCCESS: Specified value was saved. d. Quit command prompt by typing exit then pressing [Enter]

This will provide you with bash (and SSH) in the Git Bash program.


The default shell in all versions of Mac OS X is Bash, so no need to install anything. You access Bash from the Terminal (found in /Applications/Utilities). You may want to keep Terminal in your dock for this workshop.


The default shell is usually Bash, but if your machine is set up differently you can run it by opening a terminal and typing bash. There is no need to install anything.


All students should have an SSH client installed. SSH is a tool that allows us to connect to and use a remote computer as our own. Please follow the directions below to install an SSH client for your system.


You should have SSH available in Git Bash after you installed it according to the instructions above.

An alternative is to install MobaXterm from You will want to get the Home edition (Installer edition). However, if Git Bash works, you do not need this.


macOS comes with SSH pre-installed, so you should not need to install anything.


Linux users do not need to install anything, you should be set!