Set up your computer

Before accessing Gadi, you will need to have an NCI account. Ensure you have completed this step by following directions on the Gadi Access instructions on the previous page before proceeding.

To work on NCI Gadi, you will need to use a terminal application on your local computer or work on NCI’s Australian Research Environment (ARE) platform, which includes a web-based terminal interface to Gadi. If you already have a terminal application that you have used to access Artemis, for example putty or Mac Terminal, you can continue to use that.

Below we will describe 3 options for accessing Gadi:

Use NCI’s ARE platform

NoteARE: fast access with limited customisation

This is a very lightweight solution for accessing Gadi, some interactive tools like Jupyter and RStudio. We recommended it for beginners who don’t want to customise their set up.

NCI has created a web-based graphical interface for accessing their systems. It is very simple to use and recommended over access methods described below for beginners.

See NCI’s User Guide for instructions on how to access and use ARE.

Install Visual Studio Code

NoteVScode: customised configuration with an integrated terminal

This is a more advanced solution for accessing Gadi, with more customisation options. We recommended it for users who are comfortable with terminal applications and want to customise their set up.

Visual Studio Code (VS Code) is a lightweight and powerful source code editor available for Windows, macOS and Linux computers. As an alternative to a terminal application it offers additional functionality including file editing.

  1. Download Visual Studio Code for your system from here and follow the instructions for:
  2. Open the VS Code application on your computer

  1. Click on the extensions button (four blocks) on the left side bar and install the remote SSH extension. Click on the blue install button.

Connect to your instance with VS code by adding the host details to your .ssh config file:

Host Gadi
  HostName gadi.nci.org.au
  User <your-nci-username>
  1. Type Ctrl+Shift+P and select Remote-SSH: Connect to Host and Gadi
  2. When prompted, select Linux as the platform of the remote host from the dropdown menu
  3. Type in your NCI password and hit enter

Having successfully logged in, you should see a small blue or green box in the bottom left corner of your screen:

To set up your VS Code window:

  1. Open a new folder in the file explorer panel on the left side of the screen by typing Ctrl + K, Ctrl + O if you’re running Windows or Cmd+K+ Cmd + O for MacOS
  2. Select /scratch/iz89 to open your workspace. You can change this at any point by opening a new folder. Keep in mind you will be requested to provide your password each time.
  3. When prompted, select the box for Trust the authors of all files in the parent folder ‘home’ then click Yes, I trust the authors
  4. To open a terminal, type Ctrl+J if you’re on a Windows machine or Cmd+J on MacOS

Tips for using VS Code

Access via a Terminal Application

Use MacOS native terminal

Mac operating systems come with a terminal program, called Terminal. Just look for it in your Applications folder, or hit Command + Space and type ‘terminal’. You may find that other, 3rd party terminal programs are more user-friendly and powerful, like Iterm2.

To log in to Gadi, you will use a Secure Shell (SSH) connection. To connect, you need 3 things:

  • The address of your NCI Gadi, gadi.nci.org.au.
  • Your Gadi username, e.g. ab1234.
  • Your password.

Then typing the following command into your terminal:

ssh <username>@gadi.nci.org.au

and provide your password when prompted.

Warning‼️ Pay Attention ‼️

When you type a password on the terminal, there will not be any indication the password is being entered. You’ll not see a moving cursor, or even any asterisks, or bullets. That is an intentional security mechanism used by all terminal applications and can trip us up sometimes, so be careful when typing or copying your password in.

Once you’ve logged in successfully, you should see a welcome screen like this:

Install a terminal client on your windows machine

Windows OS now comes with Windows Subsystem for Linux (WSL) so if you are familiar with using that, you can ssh to Gadi from a WSL terminal.

If not, you will need to install a terminal client. There are many options, including putty, Xwin-32 (which the University of Sydney has a license for), and MobaXterm.

For example, you can download the free version of MobaXterm using this link and refer to this step-by-step guide on how to set up this tool on your PC to connect to Gadi.