Skip to content

Compute Canada and Canadian HPC

Use Neurodesk tools on Canadian HPC systems through the site’s container runtime and Neurodesk’s CVMFS repository. Compute Canada is now the Digital Research Alliance of Canada. You need an account and access to your chosen cluster. For Toronto’s Trillium system, follow SciNet’s account instructions, including multifactor authentication and the Trillium access request.

  1. Connect to your cluster using its SSH instructions, or open a terminal in a scheduled remote desktop. Use the site’s interactive-job instructions to obtain a compute node before running applications.

  2. Check whether the Neurodesk repository is available on that node:

    Terminal window
    ls /cvmfs/neurodesk.ardc.edu.au/neurodesk-modules/

    Access the full path: an automounted repository may not appear in a listing of /cvmfs until you access it. If this command fails, see Missing repository or runtime.

  3. Check for a container runtime:

    Terminal window
    command -v apptainer
    command -v singularity

    If neither command prints a path, load the runtime provided by your site, for example module load apptainer or module load singularity. Grex documents module load singularity in its Neurodesk example.

  4. Add the Neurodesk module directories and find a tool:

    Terminal window
    module use /cvmfs/neurodesk.ardc.edu.au/neurodesk-modules/*
    module --ignore_cache avail fsl
    module --ignore_cache avail itksnap

    Keep the trailing /* unquoted so the shell expands the category directories. This exposes short names such as fsl and itksnap. Adding only the parent directory exposes category-prefixed names, as in the Grex example.

  5. Load ITK-SNAP and check its command path:

    Terminal window
    module load itksnap
    module list
    command -v itksnap

    The final command should resolve to a Neurodesk wrapper under /cvmfs/neurodesk.ardc.edu.au/. For reproducible work, select and record the full versioned module name from module avail.

Repeat the runtime and module setup in each new session and batch script. With Lmod, ml av fsl lists available FSL modules, ml itksnap loads ITK-SNAP, and ml lists loaded modules.

Make your data available inside containers

Section titled “Make your data available inside containers”

Set bind paths for the runtime you use. For example, from an existing working directory containing your data:

Terminal window
export APPTAINER_BINDPATH="/cvmfs,$PWD"

For Singularity, use this instead:

Terminal window
export SINGULARITY_BINDPATH="/cvmfs,$PWD"

Include the actual scratch and project directories your analysis needs, separated by commas. Preserve any additional bind paths required by your site. Use existing, accessible paths; resolve storage symlinks to their physical paths if files are missing inside the container. See the Neurocommand HPC guide for more details.

Use a browser desktop through Open OnDemand

Section titled “Use a browser desktop through Open OnDemand”

Open OnDemand is available at several Canadian sites. A site’s desktop can run individual Neurodesk tools if the repository and runtime checks above succeed. Use the site’s desktop application and load Neurodesk tools in its terminal.

  1. Open your site’s portal from the links below and sign in with the account that has cluster access.

  2. Select its interactive desktop application and request resources and a wall time appropriate for your work. Follow the site’s instructions for account and partition selection.

  3. Wait for the scheduled session to start, then connect to the desktop.

  4. Open a terminal inside the desktop and run the runtime, module, and bind-path setup above.

  5. Start the graphical tool:

    Terminal window
    itksnap

The ITK-SNAP window should open in the remote desktop. A portal’s login-shell terminal alone does not provide a graphical desktop. Save your results to persistent cluster storage and end the desktop job when finished. On-demand access still depends on available scheduler resources.

For Grex, open the Grex portal from the University of Manitoba network or its VPN. Sign in with your Alliance credentials and Duo, then select Interactive Apps and Grex Desktop. See the Grex portal guide for access requirements and resource settings.

Check /cvmfs/neurodesk.ardc.edu.au on your compute node before using these instructions. The Neurodesk repository is separate from the Alliance software repository at /cvmfs/soft.computecanada.ca.

SystemNeurodesk availabilityBrowser access
Grex, University of ManitobaAvailable through CVMFS.Open OnDemand desktops.
Trillium, SciNet / University of TorontoNot confirmed. Check the repository on your compute node.SciNet Open OnDemand, confirmed by SciNet’s service documentation.
Nibi, SHARCNET / University of WaterlooNot confirmed. Check the repository on your compute node.SHARCNET Open OnDemand, documented in SHARCNET’s migration guide.
FirNot confirmed. Check the repository on your compute node.JupyterLab with a remote desktop, documented in the 2026 remote visualization training, slide 38.
NarvalNot confirmed. Check the repository on your compute node.JupyterLab with a remote desktop, documented in the same training.
RorqualNot confirmed. Check the repository on your compute node.JupyterLab with a remote desktop, documented in the same training.

The same training documents the remote desktop route for Trillium and Nibi through Open OnDemand. For Fir, Narval, and Rorqual, use the portal linked from the cluster’s Alliance documentation, start JupyterLab, and open its remote desktop before running the Neurodesk setup commands.

For other Canadian clusters, check the Neurodesk repository and container runtime on a compute node using the setup steps above.

If the Neurodesk path is unavailable, ask the site’s support team whether it can enable neurodesk.ardc.edu.au on both login and compute nodes. The CVMFS installation guide contains administrator setup instructions.

If the site allows user-managed containers, use the Neurocommand Linux and HPC installation to download selected tools into your own storage. This still requires the site’s supported container runtime and sufficient storage.

If a module loads but the application fails, check the runtime, bind paths, and repository from the actual compute job. For GUI failures, confirm that you launched the command inside a desktop session. Include the cluster name, hostname, module list, and the exact error when reporting a problem.