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.
Set up Neurodesk modules
Section titled “Set up Neurodesk modules”-
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.
-
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
/cvmfsuntil you access it. If this command fails, see Missing repository or runtime. -
Check for a container runtime:
Terminal window command -v apptainercommand -v singularityIf neither command prints a path, load the runtime provided by your site, for example
module load apptainerormodule load singularity. Grex documentsmodule load singularityin its Neurodesk example. -
Add the Neurodesk module directories and find a tool:
Terminal window module use /cvmfs/neurodesk.ardc.edu.au/neurodesk-modules/*module --ignore_cache avail fslmodule --ignore_cache avail itksnapKeep the trailing
/*unquoted so the shell expands the category directories. This exposes short names such asfslanditksnap. Adding only the parent directory exposes category-prefixed names, as in the Grex example. -
Load ITK-SNAP and check its command path:
Terminal window module load itksnapmodule listcommand -v itksnapThe 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 frommodule 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:
export APPTAINER_BINDPATH="/cvmfs,$PWD"For Singularity, use this instead:
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.
-
Open your site’s portal from the links below and sign in with the account that has cluster access.
-
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.
-
Wait for the scheduled session to start, then connect to the desktop.
-
Open a terminal inside the desktop and run the runtime, module, and bind-path setup above.
-
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.
Canadian system availability
Section titled “Canadian system availability”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.
| System | Neurodesk availability | Browser access |
|---|---|---|
| Grex, University of Manitoba | Available through CVMFS. | Open OnDemand desktops. |
| Trillium, SciNet / University of Toronto | Not confirmed. Check the repository on your compute node. | SciNet Open OnDemand, confirmed by SciNet’s service documentation. |
| Nibi, SHARCNET / University of Waterloo | Not confirmed. Check the repository on your compute node. | SHARCNET Open OnDemand, documented in SHARCNET’s migration guide. |
| Fir | Not confirmed. Check the repository on your compute node. | JupyterLab with a remote desktop, documented in the 2026 remote visualization training, slide 38. |
| Narval | Not confirmed. Check the repository on your compute node. | JupyterLab with a remote desktop, documented in the same training. |
| Rorqual | Not 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.
Missing repository or runtime
Section titled “Missing repository or runtime”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.