This document describes a recommended setup for a MacOS client.

SSH without X11 Forwarding

This is the standard method. Official X11 support is provided through NoMachine. For normal SSH sessions, use your SSH client as follows:

ssh $username@merlin-l-01.psi.ch
ssh $username@merlin-l-001.psi.ch
ssh $username@merlin-l-002.psi.ch

SSH with X11 Forwarding

Requirements

For running SSH with X11 Forwarding in MacOS, one needs to have a X server running in MacOS. The official X Server for MacOS is XQuartz. Please ensure you have it running before starting a SSH connection with X11 forwarding.

SSH with X11 Forwarding in MacOS

Official X11 support is through NoMachine. Please follow the document {Job Submission -> Interactive Jobs} and {Accessing Merlin -> NoMachine} for more details. However, we provide a small recipe for enabling X11 Forwarding in MacOS.

  • Ensure that XQuartz is installed and running in your MacOS.

  • For enabling client X11 forwarding, add the following to the start of ~/.ssh/config to implicitly add -X to all ssh connections:

     ForwardAgent yes
     ForwardX11Trusted yes
    
  • Alternatively, you can add the option -Y to the ssh command. In example:

     ssh -X $username@merlin-l-01.psi.ch
     ssh -X $username@merlin-l-001.psi.ch
     ssh -X $username@merlin-l-002.psi.ch
    
  • For testing that X11 forwarding works, just run xclock. A X11 based clock should popup in your client session.

     xclock