Files
gitea-pages/docs/merlin6/how-to-use-merlin/connect-from-macos.md
Hans-Nikolai Viessmann bde174b726 first stab at mkdocs migration
refactor CSCS and Meg content

add merlin6 quick start

update merlin6 nomachine docs

give the userdoc its own color scheme

we use the Materials default one

refactored slurm general docs merlin6

add merlin6 JB docs

add software support m6 docs

add all files to nav

vibed changes #1

add missing pages

further vibing #2

vibe #3

further fixes
2026-01-12 17:49:41 +01:00

1.9 KiB

title, keywords, last_updated, summary, sidebar, permalink
title keywords last_updated summary sidebar permalink
Connecting from a MacOS Client MacOS, mac os, mac, connecting, client, configuration, SSH, X11 07 September 2022 This document describes a recommended setup for a MacOS client. merlin6_sidebar /merlin6/connect-from-macos.html

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