Getting started on Mac

Revision as of 17:47, 16 August 2021 by C.carouge (talk | contribs) (NCI Virtual Desktop (VDI))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Mac operating system and Linux are both based on Unix. This means it is possible to connect to the supercomputer Gadi from the Mac straight out of the box. However, some functionalities are missing. We also recommend installing several software to improve on your experience.

XQuartz: required

You will need to install XQuartz. This software allows you to show remote windows from Gadi on your own screen. For installation, you can go to the XQuartz website and follow the prompts or use this video

SSH configuration

You will connect to remote servers (Gadi, VDI, Accessdev) using SSH. It is worth setting up SSH keys and a SSH configuration file. You can find detailed instructions on the induction page or in our SSH training video.

NCI Open OnDemand Service(OOD)

NCI's Open OnDemand Service (OOD) is an easy way to connect to NCI facilities from desktop computers. OOD provides a Linux desktop in a browser and access to JupyterLab, running on NCI's cloud

Check NCI's OOD documentation for the current installation and setup instructions [


  • Access to NCI's /g/data filesystem
  • Conda and Matlab (see NCI documentation) available
  • Doesn't require a powerful home computer
  • When viewing graphical windows, connection can be faster than via X11 on slow networks


  • Can not access /scratch

Anaconda Python / Rstudio

We recommend using Anaconda if you're working with Python on your own computer. This makes it easy to install packages like numpy and netCDF4, which depend on binary libraries. Anaconda uses the same system we use for the Conda environments at NCI. Anaconda also supports Rstudio if you work with R.

You can install the Mac native version. Unfortunately, if you keep the Mac default shell (zsh), after the installation is finished, you will need an additional step on Mac OS Catalina and newer. In a terminal, you will need to run the following command:

  • if you have installed with the graphical installer:
 bash -c "/opt/anaconda3/bin/conda init conda"
  • if you have installed with the command line installer:
 bash -c "~/anaconda3/bin/conda init conda"

If you have changed your shell to bash, the installation will work without the additional step.

You can check this video for the instructions with the graphical installer. We recommend enabling the 'conda-forge' package repository, you will find a wider variety of packages there and they are generally well supported.


VS Code is a nice code editor that can run on Windows, Mac and Linux. You can edit code locally, or use plugins to remotely connect to servers over SSH. It also integrates with Anaconda, letting you run Python programs in different environments.

File transfers

It is sometimes useful to transfer files between NCI servers and your local computer. You can do so via the command line with programs like rsync which is readily available. If you prefer a graphical interface, NCI advises you can install a program like Cyberduck. You can then use a SFTP connection. To access files on Gadi, it is preferable to use the data mover nodes: for the server's name.