59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
---
|
|
title: Connecting from a MacOS Client
|
|
#tags:
|
|
keywords: MacOS, mac os, mac, connecting, client, configuration, SSH, X11
|
|
last_updated: 07 September 2022
|
|
summary: "This document describes a recommended setup for a MacOS client."
|
|
sidebar: merlin7_sidebar
|
|
permalink: /merlin7/connect-from-macos.html
|
|
---
|
|
|
|
## SSH without X11 Forwarding
|
|
|
|
This is the standard method. Official X11 support is provided through [NoMachine](/merlin7/nomachine.html).
|
|
For normal SSH sessions, use your SSH client as follows:
|
|
|
|
```bash
|
|
ssh $username@login001.merlin7.psi.ch
|
|
ssh $username@login002.merlin7.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](https://www.xquartz.org/)**. 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}](/merlin7/interactive-jobs.html#Requirements) and
|
|
[{Accessing Merlin -> NoMachine}](/merlin7/nomachine.html) for more details. However,
|
|
we provide a small recipe for enabling X11 Forwarding in MacOS.
|
|
|
|
* Ensure that **[XQuartz](https://www.xquartz.org/)** 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:
|
|
|
|
```bash
|
|
ForwardAgent yes
|
|
ForwardX11Trusted yes
|
|
```
|
|
|
|
* Alternatively, you can add the option ``-Y`` to the ``ssh`` command. In example:
|
|
|
|
```bash
|
|
ssh -X $username@login001.merlin7.psi.ch
|
|
ssh -X $username@login002.merlin7.psi.ch
|
|
```
|
|
|
|
* For testing that X11 forwarding works, just run ``sview``. A X11 based slurm view of the cluster should
|
|
popup in your client session.
|
|
|
|
```bash
|
|
sview
|
|
```
|